Taxonomy Migration


This article guides you through migrating from your current taxonomy to a new version.

Checking for Common Source Links

Before beginning a taxonomy migration, check your document for source links used among many documents, spreadsheets, or workbooks. Also use this check to see if the document is single-sourced.

Go to the Data tab and click Doc Links. Review the list of links in the Location Finder panel on the left. If the document has common source links or is single-sourced, contact your Customer Success Manager (CSM).

Migrating a Taxonomy

This video guides you through the following sections of this article to migrate a document from the current taxonomy to a new taxonomy.

Exporting Your Current Taxonomy

NOTE: You can’t export if your document contains deprecated concepts in your current taxonomy. You must replace or remove them prior to export.

On the XBRL tab, turn on XBRL in your current taxonomy.

image alt text

On the XBRL tab, click the Advanced button, choose Taxonomy Migration, then click Export XBRL (Active Doc + Taxonomy).

image alt text

You will be prompted with the following warning:

image alt text

If you have, or are unsure if you have, multiple documents with XBRL that share a common source link, please contact your Customer Success Manager (CSM).

Click Proceed to continue:

A progress bar will indicate how far along the export process is.

You'll see a dialog box when your export is complete.

You will then be prompted to choose a location on your computer to save the taxonomy to. Click OK, then choose a location and click Save.

You will be prompted again with a warning message.

Importing to the Most Recent Taxonomy

Turn off XBRL by going to the XBRL tab and clicking the XBRL button.

image alt text

Click Select Taxonomy, then choose the US GAAP 20XX Taxonomy.

image alt text

If a taxonomy is used within a document, a green checkmark will appear next to it to indicate this.

Click the US GAAP 20XX button to Enable that Taxonomy.

You will notice your XBRL outline is now in the 20XX US GAAP Taxonomy and shows the following message:

image alt text

Importing the Exported Taxonomy

On the XBRL tab, click Advanced, then Taxonomy Migration, and choose Import/Migrate XBRL into Active Taxonomy.

image alt text

Browse to the location where you saved the exported taxonomy on your computer and select it.

You can now choose to preview the migration, or begin the migration. It is recommended that you Preview the migration.

When you’re ready to migrate, click No-Migrate.

image alt text

Your migration to the 20XX taxonomy begins. When the migration is finished, you will see a message. Click OK.

Once the migration log is saved to your computer, a message will let you know that the log is complete.

The migration log saved to your computer and your account describes the effect of the changes and also provides "action items" that need to be addressed as part of the migration process.

XBRL Document Check

On the XBRL tab, click Advanced, then Taxonomy Migration, and choose XBRL Document Check.

image alt text

XBRL Document Check performs a consistency check between EDGAR and XBRL. If there are changes, you will see alerts asking whether you want to include the changes. When the check is complete, any errors or problems encountered are reported in a log in the left-hand panel.

image alt text

Finding Extension Concepts to Review

On the XBRL tab, click Advanced, then Taxonomy Migration, and choose Find Extension Concepts to Review.

image alt text

Extension concepts are displayed in the Notifications panel at the bottom of the screen. It is recommended to review these extension concepts for any new replacement concepts in the latest taxonomy.

image alt text

Handling Deprecated Concepts

On the XBRL tab, click Advanced, then Taxonomy Migration, and choose Find Deprecated Concepts to Replace.

image alt text

Deprecated concepts are displayed in the Notifications panel.

Now you must update any deprecated concepts as part of migrating to the 20XX taxonomy.

Choose a concept, then double-click it in the Notifications panel.

image alt text

Deprecated concepts appear in the left-hand Location Finder panel. You will need to choose each concept and manually migrate it through the migration path. If no migration path is found, you will need to search for a replacement concept.

When you click on a concept, the XBRL Detail Tagging window appears. There will be a D before the concept, indicating it is Deprecated. Click on the D.

image alt text

The XBRL Migration Paths box appears, making suggestions for replacement concepts.

Choose the most accurate replacement for your concept, then click the green check mark on the new concept to apply it.

image alt text

The XBRL Migration Paths box has other information that may be useful to your migration, such as:

  • Mapping type and description

  • Deprecated concept.

  • Replacement (new) concepts.

  • Click to accept the replacement concept or view concept details.

  • Official taxonomy notes about why the concept was deprecated.

In the case of deprecated and unapplied concepts in the XBRL Outline, you will want to update them. These concepts will appear under XBRL Outline Locations. Click on the deprecated concept you wish to update.

image alt text

The concept will appear within the right-hand XBRL Outline panel. It will be grayed out to indicate that it is deprecated. Right-click the concept and choose Replace.

image alt text

You will be prompted to either manually search for a replacement concept, or have the application make recommendations by clicking the Migration Path button (recommended).

A Migration Path dialog box will appear, giving you options of concepts to update to.

NOTE: After you’ve updated your deprecated items, make sure you Share your XBRL changes.

You should also update your Project Properties so that it reflects that you are now in the 20XX taxonomy. Go to the right-hand Projects pane and click the Project Properties button.

image alt text

Go to the XBRL Settings tab in the Project Properties box and select US GAAP 20XX from the drop-down menu. Click Apply Changes.

image alt text

Finally, on the XBRL tab, click the Validate button and select Generate XBRL.

image alt text

Your project is now updated to the 20XX taxonomy.

NOTE: If you don’t change your taxonomy at the project level, and then generate XBRL, you will be prompted to choose the taxonomy you want to use:

image alt text