Moving your assets from another platform? As well as transferring your files and folders, you may want to bring over information such as tags, descriptions, product details or categories.
This information is known as metadata, and you can transfer it into Dash using a CSV spreadsheet.
This guide explains how the process works, from exporting your existing metadata to matching it with your assets in Dash.
ℹ️ Already requested help moving your content into Dash?
If you've requested migration assistance through our Dash starter kit, or you've already been in touch with our team, we can help with your metadata import too. Otherwise, you can follow the steps below to do it yourself.
Step 1: Get your assets into Dash
Before importing your metadata, you'll need the corresponding assets to be in Dash.
You can upload your assets directly or migrate them from another platform. In many cases, you can preserve your existing folder structure during this process.
If you haven't transferred your assets yet, see our getting started guide.
Step 2: Export your existing metadata
You'll need to get the information you want to transfer out of your previous platform, ideally as a CSV spreadsheet.
This might contain information such as:
Asset filenames
Tags or keywords
Descriptions
Product categories or codes
Other custom information associated with your assets
Ideally, each row should represent one asset, with separate columns for each type fo information, e.g:
💡 Tip: If you're unsure how to export your metadata, contact your previous provider to ask whether they can supply a CSV export.
Step 3: Create the corresponding fields in Dash
Dash uses fields to store information about your assets. So in the spreadsheet above, "Description", "Tags" and "Product Category" would all be fields in Dash.
ℹ️ Read more: What's a field and what are the different types?
Before importing your metadata, you'll need to create the corresponding fields in Dash. Using our example, you'd create Description, Tags and Product Category.
You don't need to add the individual values (e.g. Blue velvet sofa, Furniture, Lighting); these will be populated automatically during the import.
To create a field:
In Dash, go to Admin > Fields.
Select + New field > Create a custom field.
Choose the appropriate field type and give it a name.
Repeat for the other fields.
Step 4: Prepare your metadata spreadsheet
Now that you've created your fields in Dash, it's time to prepare the CSV spreadsheet you exported from your previous platform.
The main thing is making sure Dash knows which asset each row of information belongs to. The easiest way to do this is by matching assets using their filenames.
Match assets using their filenames
Open the CSV spreadsheet you exported in Step 2.
Find the column containing your asset filenames and rename its heading to Filename to match on.
For example, if your column is currently called Filename, you'd rename it to Filename to match on.
Make sure the other column headings match the names of the fields you created in Dash in Step 3.
Your spreadsheet should now look something like this:
A few things to remember:
Include the full filename, including its extension (e.g.
.jpgor.png).Match your field names exactly. The other column headings should match the fields you've created in Dash.
Separate multiple values with semicolons (;). For example,
sofa;blue;living room.
Check your filenames are unique
Important: Dash uses filenames to match your metadata to the correct assets, so check that you don't have multiple assets with the same filename.
If all filenames are unique, you can move on to the next step!
What if some assets share the same filename?
To help Dash match them correctly, we recommend adding two extra columns to your spreadsheet:
File size to match on: The asset's file size in bytes.
Folder path to match on: The folder where the asset is stored in Dash, e.g.
Products/Sofas.
Keep your Filename to match on column and fill in the additional details for each asset.
You can use file size alone if it uniquely identifies each asset alongside its filename, but including the folder path provides an extra check, particularly if some assets share the same file size.
What if all three details are identical?
If two assets have the same filename, file size and folder path, they're likely duplicates. In that case, check whether you need both copies and consider removing one before importing your metadata. You can contact us at help@dash.app if you're unsure.
Finally, save your spreadsheet as a CSV file, ready for import.
Step 5: Import your metadata into Dash
Once your CSV is ready, you can use Dash's metadata import tool to apply the information to your assets in bulk.
ℹ️ Tip: We recommend testing your import with just one or two assets first, to make sure everything matches correctly before updating your entire library.
In Dash, go to Admin > Import & Export > Metadata.
Under Import Metadata, click Choose file.
Select your prepared CSV file.
Once the import is complete, open a few assets to check that their fields have been updated correctly.
Frequently asked questions
Will this replace my existing metadata?
The import updates the fields included in your spreadsheet. Any existing values in those fields will be replaced by the values in the CSV.
If you'd like to add new tags without losing existing ones, make sure your spreadsheet includes both the old and new values.
Fields that aren't included in your import spreadsheet will remain unchanged.
Can I import metadata before uploading my assets?
Your assets need to exist in Dash before the CSV metadata import can match and update them. We recommend transferring your files first, then importing any additional metadata.
Will my existing folders be transferred too?
Your folder structure can often be preserved during the asset migration itself, depending on the method used.
For tags, descriptions and other custom information, you'll typically need a separate metadata import.
Do I have to do this myself?
No! If you're migrating from another platform and have requested migration assistance from our team, we can help arrange your metadata import too.
Need help?
If you're unsure how to export your metadata, prepare your spreadsheet or match the information to your assets, we're happy to help.
Contact us using the in-app chat or email help@dash.app.




