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.
On the XBRL tab, click the Advanced button, choose Taxonomy Migration, then click Export XBRL (Active Doc + Taxonomy).
You will be prompted with the following warning:
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.
Click Select Taxonomy, then choose the US GAAP 20XX Taxonomy.
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:
Importing the Exported Taxonomy
On the XBRL tab, click Advanced, then Taxonomy Migration, and choose Import/Migrate XBRL into Active Taxonomy.
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.
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.
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.
Finding Extension Concepts to Review
On the XBRL tab, click Advanced, then Taxonomy Migration, and choose Find Extension Concepts to Review.
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.
Handling Deprecated Concepts
On the XBRL tab, click Advanced, then Taxonomy Migration, and choose Find Deprecated Concepts to Replace.
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.
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.
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.
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.
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.
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.
Go to the XBRL Settings tab in the Project Properties box and select US GAAP 20XX from the drop-down menu. Click Apply Changes.
Finally, on the XBRL tab, click the Validate button and select Generate XBRL.
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: