Note: This guide covers asset migrations supported by the Frontify Professional Services team only. It does not apply to migrations performed by third-party agencies, partners, or clients completing self-migrating.
Overview
When migrating assets from Canto to Frontify, your Canto metadata export can be used to prepare the Frontify migration metadata sheet.
The standard migration approach is to provide the original asset files through an agreed file transfer method, such as an S3 export. For Canto migrations, there may also be an alternative option: using the Direct URL of Original File column included in the Canto metadata export as the source for the asset files.
This article explains how to prepare your Canto export, which fields are required, and which decisions you should make before the migration begins.
For information on a standard S3 migration, see our help resources here.
Before you start
Before preparing your Canto export, confirm the following:
Which assets are included in the migration scope
Whether the migration will use an S3 export or Canto original file URLs
Which metadata fields should be migrated
Whether your Canto album structure should be preserved
Whether Canto Smart Tags should be migrated
Who on your team will review and approve the test migration
Disclaimer
This article is intended as general guidance for preparing a Canto export for migration into Frontify. It is based on common Canto export structures we have seen in previous migrations, but Canto is a third-party platform and may change its export format, available fields, URL behavior, or system functionality at any time.
Frontify does not control Canto’s export process, file delivery behavior, metadata structure, rate limits, or the availability of original file URLs. Your team is responsible for reviewing the Canto export, validating that the exported data is complete and accurate, and confirming that any file URLs included in the export point to the correct original assets.
Before proceeding with a full migration, we recommend reviewing the prepared migration sheet and completing a test migration with a representative sample of assets. This helps confirm that files, metadata, tags, albums, and other mapped values are handled as expected before the full migration begins.
Choosing the asset source
Recommended option: S3 export
For most migrations, Frontify recommends using an S3 export or another agreed file transfer method.
With this approach, your original files are made available in a stable location for the migration. This is usually the safest and most predictable option, especially for larger migrations.
In the Frontify migration metadata sheet, the Location field normally points to the asset’s location in the AWS S3 bucket folder and must match the asset location exactly.
Alternative option: Canto original file URLs
Canto metadata exports may include a column called:
Direct URL of Original File
In some cases, this URL can be used as the source for the asset file instead of requiring a separate S3 export. This option may be helpful when:
Preparing an S3 export is difficult
Project timelines are tight
Your Canto export already includes usable original file URLs
You want to reduce the number of export steps required from your team
Before using this method for the full migration, the URLs must be validated to confirm that they point to the full original assets.
Important considerations for Canto URL migrations
When files are migrated directly from Canto URLs, Frontify depends on Canto to serve the files during the migration. This means:
Download speed may be slower than an S3-based migration
Larger migrations may be affected by source-system download limits or rate limiting
The original file URLs must remain accessible during the migration
Your team should verify that the URLs point to full original files, not preview or transformed versions
A test migration should be completed and reviewed before using this method for the full migration.
What to export from Canto
Ask your Canto administrator to export the metadata for the assets included in the migration. Your export should include, where available:
Content IDFile NameOriginal FilenameDirect URL of Original FileDescriptionKeywordsTagsSmart TagsAlbumsRelevant custom metadata fields
Relevant native Canto properties
Depending on your Canto setup, your export may include many additional columns. Not every column needs to be migrated into Frontify.
Required Frontify migration fields
The Frontify migration metadata sheet requires the following fields:
Frontify Field | Required? | Recommended Canto source |
ID | Yes |
|
Filename | Yes |
|
Location | Yes | S3 path, or approved Canto original file URL |
Title | Yes |
|
The first four metadata fields in the Frontify migration sheet are mandatory: ID, Filename, Location, and Title. For more information on the metadata sheet, see here.
Click the drop-downs below to learn more about how to map each value to Frontify:
ID
ID
We require a unique ID for migration sheets, so use the Canto Content ID as the asset ID. This will be unique for each asset and is usually the best identifier to use from the Canto export.
Example:
abc123456789
Filename
Filename
Use the Canto File Name or Original Filename. The filename should include the correct file extension.
Example:
logo.png
campaign-video.mp4
brand-guidelines.pdf
Frontify recommends that filenames avoid special characters (especially commas) or accents, and use characters such as letters, numbers, periods, underscores, and hyphens.
Location
Location
For standard migrations, Location should point to the file’s location in the S3 export.
Example:
frontify-ts-transfer/Company/Brand Assets/Logos/logo.png
For approved Canto URL migrations, the migration team may use:
Direct URL of Original File
Do not use the following Canto fields as the migration source file location:
Preview URL
Direct URL of Preview Image
These point to preview or interface URLs rather than the original file and will be lower in quality.
Title
Title
The Title is the asset name shown to users in Frontify.
If you do not have a dedicated title field in Canto, use the filename or a cleaned version of the filename.
Example:
Filename | Suggested title |
summer_campaign_hero.jpg | Summer Campaign Hero |
product-logo-blue.png | Product Logo Blue |
brand-guidelines-v3.pdf | Brand Guidelines V3 |
If no title is provided in the metadata sheet, Frontify falls back to the filename without the extension.
Canto to Frontify field mapping
Use the following table as a starting point when preparing your Canto export for migration.
For a sample sheet, click the link below to see an export sample vs how it's mapped for Frontify.
Canto export field | Frontify migration field | Recommendation |
|
| Use as the unique asset ID. |
|
| Use as the filename. Confirm the extension is included. |
|
| Use if this is more accurate than |
|
| Use as the asset title if no better title field exists. |
| Source URL if migrating via direct download.
When using, header becomes:
| Use only if the Canto URL migration approach has been approved and tested. |
| Usually exclude | Do not use as the source file location. |
| Usually exclude | Do not use as the source file location |
|
| Map directly if descriptions should be migrated. |
|
| Decide whether to merge with tags, keep separate, or exclude. |
|
| Convert semicolon-separated values to pipe-separated values. |
|
| Customer decision required. These are AI-generated tags from Canto. |
|
| Customer decision required. See the Albums section below. |
|
| Optional. Use if you want to preserve the original creator. |
|
| Use |
|
| Canto's terms & condition column can be converted to licenses |
|
| Optional. Convert to the required date-time format. |
|
| Optional. Confirm before mapping to workflow status. |
| Usually exclude | Only use if actual related asset IDs are available. Counts such as |
| Custom metadata | Optional. |
| Custom metadata | Optional. |
| Custom metadata | Optional. |
| Custom metadata | Optional. |
| Custom metadata | Optional. Useful if you want to filter by source content type. |
| Custom metadata | Optional. |
| Custom metadata | Optional. |
| Custom metadata | Optional. |
| Custom metadata | Optional. |
| Custom metadata | Optional. |
| Custom metadata | Optional. Usually relevant for documents. |
| Custom metadata | Optional. Usually relevant for presentations. |
| Custom metadata or migration QA | Optional. Usually more useful for validation than end-user metadata. |
| Custom metadata | Rename each column to the correct metadata field name and type. |
Preparing tags, keywords, and Smart Tags
Canto exports may contain several tag-like fields:
Keywords
Tags
Smart Tags
Before migration, decide how each field should be handled.
Tags
Canto tag values may be separated by semicolons.
Example Canto value:
Campaign;Product;Social
For Frontify, tags should be separated by a pipe character:
Campaign|Product|Social
Frontify’s migration sheet expects multiple tags to be separated by |.
Keywords
Canto Keywords may contain values that are useful for search in Frontify.
You can choose to:
Merge
Keywordsinto the FrontifyTagscolumnMigrate
Keywordsas a separate custom metadata fieldExclude
Keywords
A common approach is to merge useful keywords into the Tags column.
Example:
Canto field | Original value |
|
|
|
|
Converted Frontify Tags value:
image|file|campaign|product
Smart Tags
Canto Smart Tags are AI-generated tags. Before migrating them, review whether they are useful and accurate for your asset library.
You can choose to:
Option | Description |
Exclude Smart Tags | Simply delete the column and Smart Tags are not migrated. |
Merge Smart Tags into | You can add the Smart Tags to the Tags column and they are imported |
Review and clean first | You can review Smart Tags, and remove unwanted values. You must then merge these values with the Tags column. |
If Smart Tags are migrated, they should be merged into the Tags column and separated with pipes.
Example:
campaign|product|person|outdoor|blue
Preparing multi-select metadata
Canto multi-select fields may be exported with semicolon-separated values.
Example Canto value:
EMEA; ROW; APAC
For Frontify, multi-select values should be separated with pipes:
EMEA|ROW|APAC
Frontify custom metadata columns should include the metadata field name and the field type in brackets, such as Region (Multi-select). Multi-select values should be separated by |.
Example:
Canto column | Canto value | Frontify column | Frontify value |
|
|
| `EMEA |
Preparing Canto albums
Canto Albums can be useful when deciding how assets should be organized in Frontify. However, Canto assets may appear in more than one album. In the export, multiple album paths may appear in one cell, separated by semicolons.
Example:
Company Brand Assets/FolderA/SubfolderA;Company Brand Assets/FolderB/SubfolderB
Before migration, decide how these album values should be used.
Option 1: Use one album path as the Frontify Directory
If you want to use Canto albums to create a backend folder structure in Frontify, each asset should have one clear Directory value.
Example:
Company Brand Assets/FolderA/SubfolderA
The Frontify Directory field uses / to separate folders. For example, Brand/Assets/Logo Mark creates a folder path with nested folders. The Directory field controls the backend folder structure and does not determine how assets are shown to end users in the frontend.
Because Canto may list multiple albums for a single asset, do not assume that the first album is the correct directory unless your team has approved that rule.
Option 2: Exclude albums and create a new Frontify Directory structure
If your Frontify library will use a new structure, you may choose not to migrate Canto album information.
This can be useful if you are using the migration as an opportunity to simplify or redesign your asset organization.
Option 2: Use selected album values as Frontify Collections
If you want to preserve some of the asset’s Canto album context, you may choose to map selected album values to Frontify Collections.
This can be helpful when an asset belongs to multiple meaningful groupings in Canto and you do not want to force those values into a single Directory path.
Example Canto albums:
Company Brand Assets/FolderA/SubfolderA;Company Brand Assets/FolderB/SubfolderB
Converted Frontify Collections value:
Company Brand Assets | FolderA | SubfolderA
However, this approach should be used intentionally. Collections can enhance a library by grouping related assets, but they should not replace a clear metadata strategy, a well-structured taxonomy, or thoughtful asset organization.
In general, we do not recommend creating an overwhelming number of collections from every Canto album path. Instead, review the album values and decide which ones are useful as collections in Frontify. Other album information may be better handled as custom metadata, mapped into a controlled taxonomy, or excluded if it is no longer needed.
Preparing custom metadata
Canto exports may include custom metadata columns such as:
Region
Usage Rights
Campaign Name
Internal Notes
Launch Date
Priority Score
Before migration, these columns should be renamed to the actual metadata field names you want to use in Frontify.
Frontify custom metadata columns should use this format:
Field Name (Field type)
Examples:
Region (Multi-select)
Usage Rights (Single-select)
Campaign Name (Text)
Internal Notes (Text)
Launch Date (Date)
Priority Score (Number)
Frontify supports custom metadata types such as single-select, multi-select, text, date, and number in the migration sheet.
Confirm the original Canto field type
The Canto export may not show whether a custom metadata field was originally a text field, select field, multi-select field, number field, or date field.
If you want the Frontify metadata setup to match your Canto setup, review the field types in your Canto library settings before preparing the migration sheet.
Example:
Canto export column | Example value | Frontify column |
Region |
|
|
Approved for Use |
|
|
Usage Notes |
|
|
Internal Notes |
|
|
Priority Score |
|
|
Preparing date fields
Canto exports may include date fields such as:
Expiration Date
Auto Approve Date
Date Created
Date uploaded
Date modified
If a date should be migrated into Frontify, confirm where it should be mapped.
For example:
Canto field | Possible Frontify field |
|
|
| Custom metadata, such as |
| Custom metadata, such as |
| Custom metadata, such as |
For expires_at and custom date metadata fields, Frontify requires a RFC3339_EXTENDED format (with +00:00 on the end and not Z). Example value:
2026-01-01T23:59:00+01:00
Frontify uses this date-time format for asset expiration dates and date custom metadata fields.
Preparing copyright information
Canto exports may include a Copyright field.
If the value is copyright text, such as:
©2025 Copyright Author
map it to:
Copyright_notice
By default, if there is a Copyright_notice field, a Copyright field is required in a separate column. We only accepts specific values:
COPYRIGHTED
PUBLIC
UNKNOWN
Use Copyright only if your values have been normalized to one of those accepted options. Otherwise, use Copyright_notice for the full copyright text.
Preparing workflow status
Canto exports may include a Status field, such as:
Approved
You can choose to map this to:
Workflow_status
or to a custom metadata field.
Before mapping Canto status values to Workflow_status, review the values carefully. This helps avoid creating or applying workflow statuses that do not match your intended Frontify workflow.
The Frontify migration sheet supports a Workflow_status column for applying a workflow status to migrated assets.
Reviewing native Canto properties
Canto exports may include native system properties such as:
Watermark
Version
Content Type
Color
Creation Tool
Dimensions
Resolution
Size
Uploaded by
Modified by
Date uploaded
Date modified
Pages
Slides
Codec
You do not need to migrate all of these fields if they are not relevant for you DAM. And some fields, like dimensions and size, are native to Frontify.
Before migration, decide which fields are useful for:
Searching
Filtering
Reporting
Rights management
Governance
Preserving source-system context
As a general rule, avoid migrating fields that will not be useful to your Frontify users or library managers. This keeps your library clean.
Recommended cleanup workflow
Once you’ve exported your metadata from Canto, use the steps below to prepare it for migration into Frontify. Each section covers a key cleanup task, from preserving the original export to formatting required fields, reviewing tags and albums, and deciding which metadata should be migrated.
Click each step to expand the instructions.
Step 1: Keep a copy of the original export
Step 1: Keep a copy of the original export
Do not edit the original Canto export directly. Instead, keep a record of the original export and then create a working copy that will be prepared for the Frontify migration metadata sheet.
Step 2: Confirm the asset source
Step 2: Confirm the asset source
Decide whether the migration will use:
Asset source | What to use in the metadata sheet |
S3 export | S3 path in |
Canto original file URLs |
|
If using Canto original file URLs, validate a sample of URLs before preparing the full migration sheet.
Step 3: Create the required Frontify fields
Step 3: Create the required Frontify fields
Create or rename the required columns:
ID
Filename
Location
Title
Recommended Canto sources:
Frontify field | Canto source |
|
|
|
|
| S3 path or approved original file URL |
|
|
Step 4: Decide what to do with tags and keywords
Step 4: Decide what to do with tags and keywords
Review the following fields:
Keywords
Tags
Smart Tags
Decide whether they should be merged, kept separate, cleaned, or excluded.
If values are migrated to Frontify Tags, separate them with pipes:
tag1|tag2|tag3
Step 5: Convert multi-value separators
Step 5: Convert multi-value separators
Replace semicolons with pipes for fields that allow multiple values.
This commonly applies to:
TagsKeywords, if merged into tagsSmart Tags, if merged into tagsMulti-select custom metadata fields
CollectionsAlbum values, if migrated as collections or multi-select metadata
Example:
Before: EMEA; ROW; APAC
After: EMEA|ROW|APAC
Step 6: Review albums
Step 6: Review albums
Decide whether Canto albums should become:
DirectoryCollectionsCustom metadata
Excluded from migration
If albums are used for Directory, choose one folder path per asset.
If albums are used for Collections or custom metadata, multiple values can be preserved with pipe separators.
Step 7: Rename custom metadata columns
Step 7: Rename custom metadata columns
Rename generic Canto custom metadata columns to the final Frontify metadata field names.
Example:
Region
becomes:
Region (Multi-select)
Confirm the correct field type before migration.
Step 8: Review optional native properties
Step 8: Review optional native properties
Decide whether to migrate native Canto fields such as:
Content TypeColorCreation ToolDimensionsResolutionSizeUploaded byModified byVersion
Only migrate fields that will be useful in Frontify.
Test migration
Before running the full migration, We prefer completing a test migration with a representative sample of assets.
This is especially important if using Canto original file URLs.
The test migration should confirm:
The asset files download successfully
The downloaded files are the expected original files
File names and titles are correct
Metadata appears in the correct fields
Tags are separated correctly
Multi-select values import correctly
Albums are mapped correctly
Smart Tags are handled as expected
Expiration dates and custom date fields are formatted correctly
The migration speed is acceptable for the full project
Review and approve the test migration before proceeding with the full migration.
Customer decision checklist
Before the final migration sheet is prepared, confirm the following decisions internally so you can proceed efficiently with adjusting your metadata sheet:
Decision | Your answer |
Will the migration use S3 or Canto original file URLs? |
|
Should |
|
Should |
|
Should |
|
Should Canto |
|
If using albums for |
|
Which custom metadata fields should be migrated? |
|
What is the correct Frontify field type for each custom metadata field? |
|
Should native Canto properties be migrated? |
|
Should Canto |
|
Should expiration dates be migrated? |
|
Who will review the test migration? |
|
Final preparation checklist
Before sending the prepared migration sheet to Frontify, check that:
Every asset has a unique
IDEvery asset has a
FilenameEvery asset has a valid
LocationEvery asset has a
TitleFilenames include the correct file extensions
S3 paths or Canto original file URLs are valid
Preview URLs are not used as source file locations
Tags use pipe separators
Multi-select metadata values use pipe separators
Smart Tags have been reviewed
Album mapping has been confirmed
Custom metadata columns use the correct
Field Name (Field type)formatDate fields use the required date-time format
Copyright values are mapped correctly
Workflow status values have been reviewed
A representative test migration has been approved
Summary
A Canto metadata export can provide much of the information needed for a Frontify asset migration.
For most migrations, the recommended approach is to provide the original files through S3 or another agreed transfer method. For some Canto migrations, the Direct URL of Original File field may be used as an alternative source for the asset files, as long as the URLs are validated first.
Before the full migration, prepare the metadata sheet carefully, review tag and album mapping decisions, confirm custom metadata field types, and approve a test migration.
