Skip to main content

Preparing a Canto Export for a Frontify Asset Migration

Learn how to prepare a Canto metadata export for a Frontify asset migration, including required migration fields, original file URLs, tags, albums, collections, custom metadata, and formatting requirements.

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 ID

  • File Name

  • Original Filename

  • Direct URL of Original File

  • Description

  • Keywords

  • Tags

  • Smart Tags

  • Albums

  • Relevant 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

Content ID

Filename

Yes

File Name or Original Filename

Location

Yes

S3 path, or approved Canto original file URL

Title

Yes

File Name, cleaned filename, or another agreed title field

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

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

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

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

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

Content ID

ID

Use as the unique asset ID.

File Name

Filename

Use as the filename. Confirm the extension is included.

Original Filename

Filename

Use if this is more accurate than File Name.

File Name or cleaned filename

Title

Use as the asset title if no better title field exists.

Direct URL of Original File

Source URL if migrating via direct download.

When using, header becomes:

download_url

Use only if the Canto URL migration approach has been approved and tested.

Preview URL

Usually exclude

Do not use as the source file location.

Direct URL of Preview Image

Usually exclude

Do not use as the source file location

Description

Description

Map directly if descriptions should be migrated.

Keywords

Tags or custom metadata

Decide whether to merge with tags, keep separate, or exclude.

Tags

Tags

Convert semicolon-separated values to pipe-separated values.

Smart Tags

Tags or exclude

Customer decision required. These are AI-generated tags from Canto.

Albums

Directory, Collections, or custom metadata

Customer decision required. See the Albums section below.

Author

Author (Creator)

Optional. Use if you want to preserve the original creator.

Copyright

Copyright_notice or Copyright

Use Copyright_notice for copyright text. Use Copyright only if values are normalized.

Terms & Conditions

Licenses

Canto's terms & condition column can be converted to licenses

Expiration Date

expires_at

Optional. Convert to the required date-time format.

Status

Workflow_status or custom metadata

Optional. Confirm before mapping to workflow status.

Related Files

Usually exclude

Only use if actual related asset IDs are available. Counts such as 1 Files are not enough to create relations. We need to know the asset IDs to match files together.

Uploaded by

Custom metadata

Optional.

Modified by

Custom metadata

Optional.

Date uploaded

Custom metadata

Optional.

Date modified

Custom metadata

Optional.

Content Type

Custom metadata

Optional. Useful if you want to filter by source content type.

Color

Custom metadata

Optional.

Creation Tool

Custom metadata

Optional.

Dimensions

Custom metadata

Optional.

Resolution

Custom metadata

Optional.

Size

Custom metadata

Optional.

Pages

Custom metadata

Optional. Usually relevant for documents.

Slides

Custom metadata

Optional. Usually relevant for presentations.

MD5

Custom metadata or migration QA

Optional. Usually more useful for validation than end-user metadata.

Custom Metadata 1, Custom Metadata 2, etc.

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 Keywords into the Frontify Tags column

  • Migrate Keywords as a separate custom metadata field

  • Exclude Keywords

A common approach is to merge useful keywords into the Tags column.

Example:

Canto field

Original value

Keywords

image;file

Tags

campaign;product

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 Tags

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

Custom Metadata 1

EMEA; ROW; APAC

Region (Multi-select)

`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

EMEA; ROW; APAC

Region (Multi-select)

Approved for Use

Yes

Approved for Use (Single-select)

Usage Notes

Campaign launch asset

Usage Notes (Text)

Internal Notes

Detailed internal instructions

Internal Notes (text)

Priority Score

10

Priority Score (Number)


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

Expiration Date

expires_at

Date Created

Custom metadata, such as Original Creation Date (Date)

Date uploaded

Custom metadata, such as Original Upload Date (Date)

Date modified

Custom metadata, such as Original Modified Date (Date)

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

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

Decide whether the migration will use:

Asset source

What to use in the metadata sheet

S3 export

S3 path in Location

Canto original file URLs

Direct URL of Original File, after validation

If using Canto original file URLs, validate a sample of URLs before preparing the full migration sheet.

Step 3: Create the required Frontify fields

Create or rename the required columns:

ID
Filename
Location
Title

Recommended Canto sources:

Frontify field

Canto source

ID

Content ID

Filename

File Name or Original Filename

Location

S3 path or approved original file URL

Title

File Name, cleaned filename, or another title field

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

Replace semicolons with pipes for fields that allow multiple values.

This commonly applies to:

  • Tags

  • Keywords, if merged into tags

  • Smart Tags, if merged into tags

  • Multi-select custom metadata fields

  • Collections

  • Album values, if migrated as collections or multi-select metadata

Example:

Before: EMEA; ROW; APAC
After: EMEA|ROW|APAC

Step 6: Review albums

Decide whether Canto albums should become:

  • Directory

  • Collections

  • Custom 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

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

Decide whether to migrate native Canto fields such as:

  • Content Type

  • Color

  • Creation Tool

  • Dimensions

  • Resolution

  • Size

  • Uploaded by

  • Modified by

  • Version

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 Keywords be migrated?

Should Keywords be merged into Tags?

Should Smart Tags be migrated?

Should Canto Albums become Directory, Collections, custom metadata, or be excluded?

If using albums for Directory, how should the primary album be selected?

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 Status map to Workflow_status?

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 ID

  • Every asset has a Filename

  • Every asset has a valid Location

  • Every asset has a Title

  • Filenames 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) format

  • Date 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.

Did this answer your question?