Upload Assets via Mass Uploader

  • Updated

If you have a large batch of assets you want to upload to your Asset Bank, you can use the Mass Uploader. Your files must be accompanied by a CSV file listing your metaproperties and their values, which will then automatically populate the metaproperties and tags. Depending on your settings, new metaproperty options can also be created automatically.

If derivatives are set up for your portal, the Mass Uploader will create them upon upload.

If you want to upload new versions to existing assets in batches, use the Mass Version Updater. 

How to enable the Mass Uploader?

Contact your Customer Success Manager, who can provide additional information and provide any associated costs.

 

Who can use the Mass Uploader

Users with the following permission can use the mass uploader

  • Upload Assets

Before Using the Mass Uploader

Before you begin, please map the metaproperty and metaproperty options to the corresponding columns in your CSV file. Once the mapping is in place, you can prepare your CSV file and upload it to your files. 

  • The Mass Uploader does not take into account the required fields and dependencies. The files will still be uploaded if the CSV file contains only some of the required metaproperties and fields.
  • Additionally, the Mass Uploader can extract EXIF/XMP/IPTC information. If the metaproperties in the CSV file contain values, they take precedence; however, if the values are missing, then the EXIF/XMP/IPTC information is retrieved. 

How to Create CSV File

The CSV file needs to contain several required fields. You can optionally add columns to upload your metaproperty and metaproperty options. Follow the steps below to set up your CSV file.

  1. View this example spreadsheet and use it to get started.

  2. If using the Legacy Brand Structure, please look at it here.
  3. Enter the filename in the first row of column B. This column will link your CSV file data to the corresponding files. 

    The filename needs to be unique. Otherwise, the mass uploader will not validate

  4. Please include the exact extension in the filename. Extensions are case-sensitive, so JPG and .jpg will not match.
  5. Enter a name in the first row of column C, where you can later enter the names you want to assign to the assets.
  6. Enter tags in the first row of column D. In this column, you can enter the tags you want to add to the assets.
  7. Enter a description in the first row of column E. You can enter the descriptions you want to add to the assets in this column.
  8. (Optional) Columns F-XFD can be used for your custom metaproperties. Enter the names of the metaproperties in the first row of the designated column.
  9. List all the file names in column B, including the file extension.
  10. (Optional) In each row of column A, enter the ID of the brand you want to tag the asset with. To get your Brand ID, go to Settings > Taxonomy > Brands and click on the brand. Copy the ID from the URL in the address bar of your browser.
  11. In column C's rows, enter the names of the files you want to have within Bynder.
  12. In the rows of column D, enter the tags you want the assets to have. The system will create tags that do not exist. Use commas to separate tags.
  13. In the rows of column E, enter the descriptions for your assets.
  14. In the rows of column F-XFD, enter the labels of the metaproperty options you want to tag the assets with. You can assign multiple metaproperty options of the same metaproperty by separating them with a comma.

    Note

    Depending on your portal configuration, if a metaproperty option includes a comma, a new metaproperty option will be added, or the asset will fail to upload. 

    Note

    Multiselect must be enabled on a metaproperty level for Select, Select2, and Autocomplete metaproperties. Read more about this option here.

  15. Save your file as a semicolon-separated CSV file in UTF-8 encoding. Download a CSV example file here

    • Please see here if your file is not saved as a semi-colon-separated document.

Important Information on Labeling Your CSV File

  • Do not use trailing spaces. Ensure all trailing whitespace is removed from your CSV file before submitting it.

  • Use the metaproperty option labels in your CSV file and not the metaproperty option names

  • Using diacritics (ë, ç, û, etc.) in filenames could cause issues when reading them .csv while uploading using the mass uploader. This is caused by the many ways these characters can be composed using Unicode.

    • Workaround:

      'Normalize' the filenames and use the Latin alphabet without the diacritics. Thålin.jpg -> Thalin.jpg. The diacritics can still be used for titles.

How to Use the Mass Uploader

Once your CSV file is prepared and metaproperty mapping is complete, you can start batch-uploading your files. 

  1. Make sure your CSV file includes at least one asset's data.

  2. Click your name in the top right corner of the screen and click Mass Uploader.

  3. Drag and drop your CSV file to the left sidebar or click Add Files to upload your CSV file.

  4. If your CSV file is processed correctly, you will see the message "Your CSV file was successfully parsed." If not, read the error message, adjust your CSV file, and submit it again.

  5. You can drag and drop your files to the left sidebar or click Add Files. They will automatically start uploading and tagging with the metadata from the CSV file.

  6. Once a file is uploaded correctly, the status will change to Successful.

  7. After successfully uploading, you can directly click on a file name that links to that asset.

Limitations

  • You can't mark assets as limited usage, archived, downloadable, or public or add a watermark to them using the Mass Uploader.
  • If a derivative is configured with a regex, the uploaded asset's filename must begin with that specified regex for the derivative to be created via the Mass Uploader. The normal uploader does not have this requirement.
  • The Mass Uploader doesn't generate automated tags.
  • The Mass Uploader won't index the content of digitized documents, such as PDF and Word documents. This means that when you enter their content in the search bar, these documents won't be returned as a search result.
  • The Mass Uploader is not meant to update metadata such as filenames. 

FAQ

Why is my CSV file not saving as a semicolon-separated CSV file?

Some software, by default, saves your spreadsheets as comma-delimited files. Follow the alternative instructions below to make a semicolon-separated CSV file.

  1. If there are commas in your spreadsheet, do a Find and Replace of all commas (,) into another symbol that is not used, like a caret (^) or star (*)
  2. Save the spreadsheet as a Comma Separated Value text file (.csv)
  3. Open the .csv file in a text editor, such as TextWrangler.
  4. Press Ctrl+F (Windows) or Cmd+F (Mac) to open the search function.
  5. Paste the comma (,) into the Find box, fill in a semicolon (;) in the Replace box, and replace all.
  6. If you had commas in the original spreadsheet, paste the symbol in Step 1 into the Find box, fill in the comma (,) in the Replace box, and replace all.
  7. Save the file
  8. Drop this .csv version of the sheet onto the Mass Uploader and wait for a success message.
  9. Then, drop the files onto the Mass Uploader and wait for each success message.
How many files can I upload at once with the Mass Uploader?
No hard limit is in place, but we recommend uploading files in batches of 500.
Does the Mass Uploader consider the required fields that are set up for my portal?
The Mass Uploader does not consider the required fields for your portal. It will still be uploaded even if the CSV file contains only some of the required metaproperties and fields.
Does the Mass Uploader take into account the dependencies that are set up for my portal?
The Mass Uploader does not take into account dependencies. Files with metaproperties requiring a dependency during the normal upload process will still be uploaded even if this dependency is not filled in.
Do I need to include the 'Brand' column in my CSV file?
If you're still using the legacy Brands structure, you can Remove the Brand column from your CSV file if only one brand is listed.
Why is my CSV file not saving as a semicolon-separated CSV file?
  1. Save the spreadsheet as a Tab Delimited Text (.txt) file.
  2. Open this .txt file in a text editor, such as TextWrangler.
  3. Copy the tab separating two of the items.
  4. Press Ctrl+F (Windows) or Cmd+F (Mac) to open the search function. Paste the tab into the Find box and fill in the Replace box.
  5. Save this now semicolon delimited file as .csv manually (by adding .csv to the filename).
  6. Drop this .csv version of the sheet onto the Mass Uploader and wait for a success message. Then, drop the files onto the Mass Uploader and wait for each success message.
Why do I see an error message when uploading my CSV file?
If the error messages don't provide enough information to fix your file, please ensure your CSV file meets the following requirements.
Why the Mass Uploader is not responding when uploading my CSV file?
Make sure your CSV file includes at least one asset's data. If only the columns in the first row of the CSV file are available with another row with actual asset data, the Mass Uploader will respond.

For Customers on Legacy Brand Structure

  1. (Optional) If you're still using the old discontinued Brands structure, enter Brand in the first row of column A

  2. How do I find out whether I'm using the old Brand structure?

    1. Go to Settings > Taxonomy > Brands and check the number of brands listed. You are using the old brand structure if you have more than one brand set up. If only one brand is listed, remove the Brand column from your CSV file.

    2. Remove the complete column if only one Brand has been set up for the portal. Since our legacy brand structure is discontinued, this column can be excluded for only some portals.

Was this article helpful?

1 out of 2 found this helpful

We're sorry to hear that!

Find out more in our community

Have more questions? Find out more in our community