All articles
CSRDXBRLDigital TaggingESRSSustainability Reporting

CSRD Digital Tagging and XBRL: How to Prepare for Machine-Readable Sustainability Reports

The CSRD requires companies to digitally tag sustainability reports using XBRL. Learn what XBRL tagging means, which data points need marking up, timelines, software options, and practical steps to get ready.

João Aguiam

João Aguiam

· 9 min read

CSRD Digital Tagging and XBRL: How to Prepare for Machine-Readable Sustainability Reports

Most conversations about CSRD compliance focus on what to report — materiality assessments, emissions data, social metrics. But there's a technical requirement that catches many companies off guard: digital tagging. Under the CSRD, sustainability reports must be published in a machine-readable format using XBRL (eXtensible Business Reporting Language), specifically the inline XBRL (iXBRL) standard.

This isn't optional. It's baked into the directive. And for companies already wrestling with data collection and narrative drafting, the digital tagging requirement adds another layer of complexity that needs planning well in advance.

What Is XBRL and Why Does the CSRD Require It?

XBRL is an open data standard that makes financial and non-financial information machine-readable. Instead of publishing a PDF that humans read, you publish a document where every data point is "tagged" with a standardised label. Software, regulators, investors, and data aggregators can then extract, compare, and analyse information automatically — across companies, sectors, and countries.

The EU has required XBRL tagging for financial statements under the European Single Electronic Format (ESEF) since 2020. The CSRD extends this requirement to sustainability reporting. The logic is straightforward: if thousands of companies across Europe are reporting under the same ESRS standards, the data should be comparable by machines, not just by humans reading narrative text.

For regulators, this enables automated supervision. For investors, it means sustainability data becomes as queryable as financial data. For companies, it means an additional technical step in the reporting process.

The ESRS XBRL Taxonomy: What Gets Tagged

EFRAG (the European Financial Reporting Advisory Group) has developed a dedicated XBRL taxonomy for the ESRS. This taxonomy defines the standardised labels — called "elements" or "concepts" — that companies use to tag their disclosures.

What the taxonomy covers

The taxonomy maps to all 12 ESRS standards and includes:

  • Quantitative data points — GHG emissions (Scope 1, 2, and Scope 3), energy consumption, water usage, workforce headcount, gender pay gap, board diversity percentages, and hundreds more
  • Qualitative disclosures — Policies, targets, action plans, governance descriptions, and risk narratives (these use "block tagging," where sections of text are tagged as a whole)
  • Cross-cutting disclosures — Basis for preparation, double materiality outcomes, value chain boundaries, and time horizons
  • Entity-specific disclosures — Where companies report beyond the standard data points, the taxonomy allows extensions

The taxonomy contains over 1,000 data points. Not every company will tag all of them — only those that are material based on your double materiality assessment. But the data points you do disclose must be tagged correctly.

Block tagging vs. detailed tagging

There are two levels of tagging granularity:

  1. Block tagging — Large narrative sections are tagged as a whole (e.g., "Description of climate-related transition risks"). This is similar to how ESEF handles notes to financial statements.
  2. Detailed (granular) tagging — Individual numbers, dates, and percentages are tagged with specific elements. This applies to most quantitative disclosures.

The initial rollout emphasises block tagging for narrative disclosures, with detailed tagging for quantitative metrics. Expect granularity requirements to increase over time as the taxonomy matures.

Timeline: When Does Digital Tagging Apply?

The digital tagging requirement follows the same phased rollout as the CSRD itself:

WaveCompaniesFirst report (covering FY)Digital tagging required
Wave 1Large PIEs (already under NFRD)FY 2024 (published 2025)Yes, from first report
Wave 2Other large companiesFY 2025 (published 2026)Yes, from first report
Wave 3Listed SMEsFY 2026 (published 2027)Yes, though opt-out possible until 2028

Key point: There is no grace period for digital tagging. Unlike some other CSRD provisions, XBRL tagging is required from your very first sustainability report. Companies in Wave 2 preparing reports right now need to have their tagging approach sorted.

For SMEs not directly in scope, XBRL tagging doesn't apply — but understanding the format helps when larger customers request structured data through the value chain.

How iXBRL Works in Practice

Inline XBRL (iXBRL) is the specific flavour of XBRL the CSRD uses. It embeds machine-readable tags directly into an HTML document, so the same file is both human-readable (it looks like a normal report in a browser) and machine-readable (software can extract tagged data).

Here's a simplified example of what iXBRL tagging looks like under the hood:

<ix:nonFraction name="esrs:GrossScope1GHGEmissions"
  unitRef="tCO2e" decimals="0"
  contextRef="FY2025">
  12450
</ix:nonFraction>

A reader sees "12,450 tCO2e" in the report. A machine reads the tag and knows this is Gross Scope 1 GHG Emissions for fiscal year 2025, measured in tonnes of CO2 equivalent, with zero decimal precision.

In practice, you won't be hand-coding these tags. Reporting software handles the tagging process through visual interfaces where you map your report content to taxonomy elements.

Software and Tooling Options

You have several options for handling XBRL tagging:

1. Integrated CSRD reporting platforms

Many sustainability reporting tools now include XBRL tagging as a built-in feature. Platforms like Workiva, Wolters Kluwer CCH Tagetik, and others offer end-to-end solutions where you draft your ESRS disclosures and tag them in the same workflow. This is the most streamlined approach for companies with budget.

2. Standalone XBRL tagging tools

If you're drafting reports in Word or another tool and need to add XBRL tagging as a separate step, standalone iXBRL tools (like those from CoreFiling, ParsePort, or IRIS CARBON) let you import your report and apply tags. This can be cost-effective but adds a step to your workflow.

3. Consultant-assisted tagging

Many CSRD consultants now offer digital tagging as part of their service package. This is especially relevant for first-time reporters who want expert help mapping their disclosures to the taxonomy. The cost varies but is typically bundled into overall reporting fees.

4. Auditor/assurance provider tools

Your assurance provider may also offer tagging services or require specific formats for their review. Coordinate early to avoid rework.

Practical Steps to Prepare

Step 1: Understand your data points

Before worrying about tagging software, map which ESRS data points are material for your company. Your double materiality assessment determines which standards and topics apply, which in turn defines which taxonomy elements you'll use.

Step 2: Choose your tooling early

Don't leave XBRL tagging as an afterthought. Evaluate software options at the same time you're setting up your data collection processes. Retrofitting tags onto a finished report is more painful and error-prone than building them in from the start.

Step 3: Align with your financial ESEF process

If your company already produces ESEF-tagged financial statements, leverage that experience and potentially the same tooling. The sustainability XBRL taxonomy is separate from the financial one, but the technical infrastructure (iXBRL rendering, validation, filing) is similar.

Step 4: Run a dry tagging exercise

Before your first mandatory report, try tagging a subset of your disclosures. This reveals gaps — taxonomy elements you can't find, data that doesn't fit neatly, narrative sections that need restructuring. Better to discover these in a dry run than under deadline pressure.

Step 5: Coordinate with assurance providers

Your auditor will need to review tagged reports. Discuss format expectations, validation checks, and any specific tooling requirements before finalising your approach. This avoids last-minute compatibility issues.

Step 6: Train your team

The people drafting sustainability reports need to understand — at least at a basic level — how tagging works and why report structure matters for it. They don't need to become XBRL experts, but they need to know that changing a table structure or rewriting a disclosure heading can affect tagging.

Common Pitfalls to Avoid

Treating tagging as a last step. Companies that draft their full report and then try to tag it often find structural mismatches. Build tagging awareness into your report design from the start.

Ignoring taxonomy updates. EFRAG updates the XBRL taxonomy as the ESRS evolves. Stay current — using an outdated taxonomy version will cause validation errors when filing.

Over-relying on block tagging. While block tagging is easier, it provides less useful data for investors and regulators. Where detailed tagging is feasible, it improves your report's machine-readability and can demonstrate reporting maturity.

Skipping validation. XBRL has built-in validation rules. Run validation checks before filing — they catch tagging errors, missing contexts, and inconsistencies that manual review might miss.

The Bigger Picture: Why This Matters

Digital tagging might feel like a bureaucratic checkbox, but it represents a fundamental shift in how sustainability information flows. When every company in scope reports using the same taxonomy in machine-readable format, the entire ecosystem changes:

  • Investors can screen and compare ESG performance across thousands of companies instantly
  • Regulators can monitor compliance at scale without manually reviewing PDFs
  • Rating agencies get structured data instead of scraping reports
  • Companies can benchmark themselves against peers automatically

The CSRD's XBRL requirement is what turns sustainability reporting from a narrative exercise into a data infrastructure. Companies that embrace it early — rather than treating it as an annoying technical requirement — will find it easier to iterate, improve, and demonstrate progress over time.

Next Steps

If you're preparing for your first CSRD report, add XBRL tagging to your project plan now. Evaluate tooling, run a dry exercise, and coordinate with your assurance provider. And if the technical complexity feels overwhelming, a specialist consultant can help you set up the right infrastructure from the start.

The data is the hard part. Once you have it, tagging is a technical exercise — but one that needs to be planned, not improvised.

Need Help with CSRD Compliance?

Browse our directory of vetted CSRD and sustainability consultants to find the right expert for your organisation.

Find CSRD Experts →

Join the CSRD Experts Directory

Get discovered by organizations seeking CSRD and sustainability expertise. Join a growing community of verified consultants.

🔍

Visibility

Get found by companies actively searching for CSRD consultants.

🤝

Networking

Connect with peers and discover collaboration opportunities.

📈

Lead Generation

Receive qualified inquiries from organizations that need your expertise.

Submit Your Profile →