Bulk Import: Updating Landers in Voluum

The bulk import feature is based on the mechanism of updating many entities at once using the CSV table format. Voluum enables you to modify the existing landers in bulk. In general, there are three major steps of the updating process: first, you need to download all landers that are already in Voluum, next update them locally, and then, upload to Voluum only those ones that have been modified. If you have not touched part of the landers in the CSV file, those entities might be removed from the file to speed up the process of importing them. Those landers will be still available in Voluum, but they will not be updated. Let's then start with the process of updating many landers at once.

I.  Export Landers from Voluum


To be able to modify the existing landers, you need to download them from Voluum to your local machine.   



  
    
                     



To export landers from Voluum, perform the following steps:

1. Sign in to Voluum.

2. Go to Landers. The Landers view will show up.

3. Click the Bulk actions > Export all landers drop-down button. The confirmation pop-up window will show up.

4. Click the Ok button to confirm that you want to export all landers from Voluum. 

5. Save the CSV file with the exported landers locally on your machine.


Voluum Note:

 Keep in mind that you should always save a copy of the originally exported CSV file locally, in case you would like to reverse changes after applying them to Voluum. The Voluum platform offers a bulk import for new or edited landers. There is no automated way of canceling the updates, so you would not be able to do this without the copy of the original CSV file. 
6. If the CSV file contains more than 250 landers, you need to split it into smaller files where each of them can contain maximum 250 rows with landers and one row (the first one) with a description.  




 



















II. Update the Landers Locally


Once you have got the CSV file with the exported landers, you can update the lander's properties. While modifying the landers, you need to remember to keep the Voluum's data structure in the file. Otherwise, you wouldn't be able to upload the CSV file to Voluum.


 
  
    
                     

1. Open the downloaded Voluum template with a CSV editor that works best for you.

2. Modify entries for the exported landers following basic rules listed below:

2a. The file must be properly formatted CSV and saved using UTF-8 character encoding.

2b. One CSV file can contain up to 250 landers. It means that there should be up to 251 rows in the file - the first row is dedicated for a description of columns.

2c. One lander is represented on a separate row in the CSV file.

2d. In the file, each row must end with a line break.

2e. Each column must be separated with a semicolon.

2f. Lander's properties are added according to a certain pattern delivered within the Voluum template.


Before you start editing the CSV file, read more about the way how the Voluum's data should be stored:

Bulk Import: A CSV Template with Edited Landers

Each row in the CSV file might contain the listed pieces of information for one landers. Note that only certain pieces of information are required and they are associated with the required fields in the lander's form in Voluum. Other properties might remain blank. 

Lander ID
:
{lander_ID_specific_for_Voluum} ; # Property required; the lander ID is automatically available in the downloaded CSV file

Lander's name: {your_unique_custom_name} ; # Property required 

Lander's URL: {your_lander_URL} ;  # Property required 

Country: {two-letter_country_code} ;
# Property optional; if blank the Global value will be set 

Tags
: {tags_separated_by_spaces} ;
# Property optional


3. Remove those lander entities that you have not modified. Thus, you can accelerate the process of uploading the file to Voluum. Only the landers available in the CSV file will be modified. Other lander entities with their properties will remain the same. 


Voluum Info: Every time when you upload entities (offers or landers) in bulk, only those ones will be updated that are stored in the CSV file. Other entities will neither be changed nor removed.

Bulk Import: A CSV Template with Edited Landers



4. Save the CSV files with the landers locally on your machine. 
The file must be properly formatted and saved using UTF-8 character encoding.


   

 















 






















III. Import the Updated CSV File to Voluum


When you have finished updating the landers in the CSV file, you only need to upload the file to the Voluum platform.
 
  
    
                      

To update the modified landers, go to the Voluum platform and upload the file:  

1. Sign in to Voluum.

2. Go to Landers. The Landers view will show up.

3. Click the Bulk actions > Import edited landers drop-down button. The Import edited landers form will show up.

4. Click the Start importing button in the form (bottom right screen). The file upload screen will show up.


Voluum Tip: You need to follow a data pattern implemented in the Voluum platform to be able to upload many landers at once. It is highly recommended to always use the CSV template while importing landers in bulk.  


5. Select the prepared CSV file and upload it to Voluum.

6. Wait until the CSV file will upload to Voluum. If any data is provided inaccurately, a list of errors will get displayed in the bulk import form. Moreover, you will also find tips how to correct rows with the landers in the file to make it work properly.



7. Once the CSV file is uploaded to the Voluum platform, click the Import button (bottom right screen). You should see the message that the process of importing landers in bulk has finished successfully. The landers should be updated in Voluum. You might notice applied changes in the Landers view.

8. Click the Close button in the Import edited landers form. You have successfully updated the landers in the Voluum platform.  

    

 















































Frequently Asked Questions:

Have more questions about the bulk import of edited landers? You might find the answer below:

  • What to do if I have more than 250 landers to be updated?

If you need to modify more than 250 landers to the Voluum platform, you first need to download the CSV file with all landers, then split it to the CSV files with a set of 250 landers per file, and next, update the landers. Once the landers are modified and saved in all the CSV files, you need to update the CSV files one by one to the Voluum platform.

  • Is there any maximum size of the CSV file that can be uploaded?
Yes, you can upload the file with a maximum size up to 5 MB.
  • Can I remove landers that I have updated in bulk?
No, you cannot remove them. In general, you cannot remove entities in Voluum. If you do not need to use the landers, you can always archive them.
  • Can I accidentally remove the landers while uploading the CSV file?
No, you cannot do it. For example, if you have 150 landers already created in Voluum and you want to modify 50 of them, you need to download all of them, but then you can update those 50 landers. Other 100 landers that should remain the same can be removed from the CSV file. Eventually, you will upload the file with 50 updated landers. The other 100 landers you can find in Voluum with the unchanged status.
  • Can I add any other entities in bulk to Voluum?
Yes, you can add or modify offers. It allows you to work with up to 250 offers at once. For more information, go to the Bulk Import Overview article.







 



    Bulk Import Overview                                                        Bulk Import: A CSV Template with Edited Landers    









   Contact us







Feedback and Knowledge Base