XBRL Guide: From Taxonomy Setup to Validated Export
This guide covers the full XBRL tagging process using the Drafts add-ins for Excel and Word. Use it as your starting point and refer to the linked guides for detailed steps on each stage.
Overview
The XBRL process with Drafts follows five stages:
- Set up your taxonomy in the Portal
- Prepare your Excel and Word files
- Tag financial tables in Excel
- Tag text blocks in Word
- Export, validate, and fix in the Portal
The process is iterative — after uploading to the Portal, you will likely need to go back into Excel or Word to fix errors, then re-upload. Plan for at least one or two fix-and-reupload cycles.
Stage 1: Set up your taxonomy
Your taxonomy tells the tagger who you are and which reporting framework to use. It must be set up in the Portal before you can tag anything.
First time with Wrepit?
Go to Workspace Settings → XBRL Taxonomies → Create new taxonomy → Start from scratch. Fill in your company details, LEI code, reporting period, and select the correct base taxonomy (ESEF 2024 from 2026 onwards).
Returning from a previous year?
Use the Rollover option when creating a new taxonomy to carry over your previous tags and settings. The Portal will flag any tags that have been renamed or deprecated. Apply the rollover in Drafts Excel and Word by going to Settings → Change Taxonomy.
See Setting Up Your Taxonomy in the Portal (link) for full steps and field descriptions.
Stage 2: Prepare your files
Excel: Your files must be on SharePoint or OneDrive. All tables that need tagging must have a defined name in Excel (via the Name Box) before you open the add-in.
Word: Your files must be on SharePoint or OneDrive. You must have the Publisher role on the publication. Connect your Word document to a publication in the Portal by copying the Publication ID from the Portal and pasting it into the Drafts Word add-in.
Stage 3: Tag in Excel
Open the Drafts Excel add-in, select your taxonomy, and use the Tag Wizard to set up each financial table. Once set up, tag each column's time frame and each row's line item. Define calculations for totals and run validation before uploading.
→ See Tagging and Validating in Excel (link) for the full walkthrough.
Stage 4: Tag in Word
Open the Drafts Word add-in, connect to your publication, and select a root taxonomy statement. Highlight text blocks and apply tags. Use chapter tagging for whole sections, and insert tagged tables from Excel via Excel2Word (E2W).
→ See Tagging and Validating in Word (link) for the full walkthrough.
Stage 5: Export, validate, and fix
Once tagging is complete in both Excel and Word, upload the report from the Drafts Word add-in. The Portal will run validation and show you any errors. Fix the flagged items in Excel or Word, re-upload, and validate again until the report is clean.
→ See Export to XBRL and Validate in the Portal (link) for the full walkthrough.
Need help?
If the XBRL Taxonomies tab is unavailable in the Portal, or if you encounter issues you cannot resolve, contact Wrepit support.