Skip to main content

Bulk metadata manager app

Update Frontify library asset metadata from a CSV.

Updated over 2 weeks ago

The Bulk metadata manager app helps DAM admins quickly update asset metadata in Frontify by uploading a CSV file.

You export a CSV metadata sheet from your library, update it with the values you want to apply, and then import it back through the app. This allows you to make changes at scale without editing assets one by one.

Important: Ensure the app window and the browser tab remain open throughout the process.

Before you begin


How to use

  1. Export a metadata CSV from your Frontify library.

  2. Edit the CSV file with the metadata changes you want to apply.

    • Note that you can run a small-scale test by keeping only one or two lines in the CSV.

  3. Upload the CSV file to the Bulk Metadata Manager app.

  4. Review the detected columns and mappings, and select the columns you wish to update.

  5. Click on Process Data. Keep the window open until completion.

  6. Download the error report if prompted, fix issues, and retry.

What it does

What it does not do

  • Updates basic fields:

    • Title

    • Description

    • Expires At

    • Copyright Creator

    • Copyright Status

    • Copyright Notice

    • Alternative Text

    • Tags

  • Updates custom metadata of existing fields on an asset, if a column header matches an existing custom metadata field name and type in the library.

  • If a new value exists in the CSV for a custom metadata field, it will be created in the library and then added to the asset.

  • If a new custom metadata field is added in the CSV and at least one asset has a value for that field, the new custom metadata field will be created in the library.

  • Removes values from an asset when its CSV cell for that field is empty. This includes custom metadata values.

  • Produces a CSV error report on failure.

If it's not listed here, assume it is not supported.

  • The app does not create new assets. This is for updating existing assets only.

  • The app only accepts CSV files exported from Frontify.

  • The app does not delete custom metadata fields from the library.

  • The app does not support updating the following fields:

    • Available From

    • Available To

    • Author

    • Licenses

    • Collections

    • Relations

    • Attachments

    • Preview

  • The app does not support updating multiple fields with the same name and type combination. Due to how the Frontify API handles custom metadata, the app will fail if the CSV contains multiple columns with the same name and type combination.

  • The app functions only in the browser and does not work offline.

Tips

CSV Row Limit

The app can process up to 10,000 rows of data. If you have more than 10,000 rows, you will need to split your data into multiple CSV files.

CSV Columns

Do not delete the id or the apiId columns. Feel free to delete any other columns that you do not wish to update.

Creating new custom metadata fields

If you wish to create new custom metadata fields when assigning values to an asset, you can do so by adding a new column to the CSV with the desired field name and type. The app will automatically detect the new field and create it in the target library.

The available custom metadata field types are: SELECT, MULTISELECT, TEXT, LONGTEXT, URL, NUMBER, and DATE.

To create a new custom metadata field, add the field name and type to the CSV with the following format:

field_name(type)

For example, to create a new SELECT field called "Color", you would add the following column to the CSV:

Color(SELECT)

To create a new MULTISELECT field called "Colors", you would add the following column to the CSV:

Colors(MULTISELECT)

To create a new TEXT field called "Description", you would add the following column to the CSV:

Description(TEXT)

To create a new LONGTEXT field called "Long Description", you would add the following column to the CSV:

Long Description(LONGTEXT)

To create a new URL field called "Website", you would add the following column to the CSV:

Website(URL)

To create a new NUMBER field called "Price", you would add the following column to the CSV:

Price(NUMBER)

To create a new DATE field called "Release Date", you would add the following column to the CSV:

Release Date(DATE)

Fields with multiple values

Some fields, such as MULTISELECT fields and tags, utilise a pipe character (|) to detect multiple values. To set multiple values for an asset, separate the values with a pipe character. For example, to set a MULTISELECT field to "Red" and "Blue", you would add the following value to the CSV:

Red|Blue

To set the tags field to "Red", "Blue", and "Green", you would add the following value to the CSV:

Red|Blue|Green

Multiple fields with the same name and type

If you wish to set values for multiple fields with the same name and type combination (e.g. fields that may be linked to metadata dependencies), it is recommended to temporarily rename the fields in your library backend to have unique names before exporting the CSV. This will make editing the CSV much easier, while also allowing you to update values in those fields. After the update is complete, you can rename the fields back to their original names. This will not affect frontend library filters.

Formatting dates (Expires At and DATE fields)

Spreadsheet apps may reformat dates, causing API validation to fail. If you encounter errors, try formatting your date column with this custom format (00:00 is GMT):

yyyy-mm-ddThh:mm:ss+"00:00"

The app attempts to parse many common date formats, but not all variations are supported.

Copyright status

The copyrightStatus column accepts only these values: PUBLIC, COPYRIGHTED, UNKNOWN. If a different value is provided, the app will set the value to UNKNOWN.

Troubleshooting

  • The progress bar stops moving: The app makes use of exponential backoffs to retry failed updates. If you are updating many assets, be patient and give it a few minutes β€” it should restart automatically. Another possibility is the app is retrying a failed update. Opening the browser console may provide more information.

  • Nothing updates: Confirm the CSV is exported from the correct Frontify library and that you have selected the correct columns to update.

  • Date fields failed to update: Reformat as shown above; avoid localized month/day names.

  • Fields with multiple values update incorrectly: Fields with multiple values such as MULTISELECT fields and tags utilize a pipe character | to detect multiple values. Please check the CSV for any values that are not separated by a pipe character.

Output and reports

  • On success, assets are updated in Frontify.

  • Empty cells clear existing values for that field on the asset.

  • On failure, an error CSV is provided describing the issues per row.


Disclaimer

  • The app is in beta

  • Feedback is very welcome. Contact us.

Did this answer your question?