All posts

The VSME Digital Template and XBRL taxonomy explained

Blog
EFRAG VSME Digital Template Excel spreadsheet and XBRL sustainability reporting conversion

When EFRAG issued the VSME standard in December 2024, it did not stop at publishing a PDF. It also released a Digital Template — an Excel workbook that SMEs can fill in and convert to machine-readable XBRL format — alongside an open-source XBRL taxonomy and an online converter. Now at version 1.2.0 (February 2026), these tools represent EFRAG’s attempt to lower the entry barrier to digital sustainability reporting for companies that may never have produced a structured ESG disclosure before.

This article examines what the Digital Template offers, how the XBRL ecosystem works, and where the limitations are. EFRAG has been unusually transparent about the template’s constraints — it is explicitly positioned as educational guidance, not a commercial-grade reporting solution. Understanding the gap between what the free template provides and what operational VSME reporting requires is essential for any SME or institution planning its implementation.

What the Digital Template contains

The VSME Digital Template is an Excel workbook organised into four data-entry sheets, each covering a different ESG dimension. EFRAG deliberately regrouped disclosures by topic type rather than following the Basic/Comprehensive module structure, based on feedback from SME Forum members who found this arrangement more intuitive.

General information
XBRL metadata, B1 (basis for preparation), B2 (practices and policies), C1 (business model), C2 (description of practices). Entity identifier, NACE codes, geolocation.
Environmental
B3 (energy and GHG), B4 (pollution), B5 (biodiversity), B6 (water), B7 (waste and circularity), C3 (GHG targets), C4 (climate risks). Fuel converter linked.
Social
B8 (workforce characteristics), B9 (health and safety), B10 (remuneration and training), C5 (additional workforce), C6 (human rights policies), C7 (incidents).
Governance
B11 (anti-corruption), C8 (controversial sector revenues and EU benchmark exclusion), C9 (gender diversity in governance body).

Each sheet includes colour-coded cells distinguishing Basic from Comprehensive Module datapoints, auto-calculated fields (shown in purple), applicability triggers (in yellow), and built-in validation that flags missing values, inconsistencies and format errors. A table of contents sheet provides an overall validation status — “COMPLETE” or “INCOMPLETE” — with checkboxes to mark disclosures omitted as classified or sensitive information.

Key features of the template

The template includes several features that go beyond a simple data collection form. A fuel converter sheet helps SMEs translate fuel consumption from litres or kilograms into MWh, with default net calorific values and density parameters sourced from IPCC data (adjustable for national circumstances). Geolocation can be auto-calculated from site addresses via a web service — though this triggers a security warning on opening the workbook. Drop-down menus cover NACE codes, pollutant types and waste categories based on EU legislation. Currency can be set from an ISO 4217 dropdown for monetary values.

The template is available in 11 EU languages (English, Danish, Dutch, French, German, Irish, Italian, Lithuanian, Polish, Portuguese and Spanish) and can generate Inline XBRL reports in any of these languages. Paragraph-level hyperlinks to the VSME standard text and guidance are embedded throughout, so preparers can click through to the relevant requirement while filling in each disclosure.

From Excel to XBRL: the conversion workflow

The Digital Template connects to EFRAG’s XBRL ecosystem through a three-step workflow.

1
Fill template
Enter data in the 4 Excel sheets. Validate until status shows COMPLETE.
2
Upload to converter
Submit Excel file to xbrl.efrag.org/convert/. Solves CAPTCHA. Auto-detects template version.
3
Download outputs
Inline XBRL report (human + machine readable), XBRL report package, and XBRL-JSON dataset.

The converter is built in Python, hosted on EFRAG’s website and available free of charge. It maps Excel named ranges to XBRL taxonomy elements, runs full XBRL validation via Arelle, and produces three output formats: an Inline XBRL report with an embedded viewer, an XBRL report package for submission, and an XBRL-JSON file for machine processing. The source code is open-source (MIT licence) and available on GitHub, allowing any software provider to integrate the conversion logic into their own platform.

A data migration tool (also released in February 2026) automates the transfer of data from older template versions to the latest one, preserving named ranges and flagging any migration issues caused by updated enumeration lists.

Version history

27 May 2025
v1.0.0 — initial release
First public version following SME Forum consultation. English only.
16 June 2025
v1.0.1 — bugfix
Minor corrections to formulas and validation rules.
3 October 2025
v1.1.0 — EC Recommendation update
Updated to reflect Commission Recommendation 2025/1710. Translation feature added (9 languages).
27 November 2025
v1.1.1 — bugfix + translations
Additional languages. Bug fixes for validation and fuel converter.
27 February 2026
v1.2.0 — current release
11 languages. Classified/sensitive info checkboxes. NACE code corrections. Data migration tool. Updated paragraph links to EFRAG Knowledge Hub.

Where the template falls short

EFRAG has been remarkably candid about the Digital Template’s limitations. The Explanatory Note explicitly states that the template is not intended to compete with commercial providers and acknowledges that dedicated web applications would be better suited for the purpose. Here are the specific constraints, drawn directly from EFRAG’s own documentation.

!

Single-period reporting only

The template supports one reporting period. No year-on-year comparisons. The VSME requires comparative information from the second year — meaning the template is suitable only for first-time reporting.

!

No GHG emissions calculator

The template collects GHG data but does not calculate it. SMEs must compute Scope 1 and 2 emissions externally using third-party tools. EFRAG recommends the EC develop a calculator.

!

No multi-entity support

Cannot produce a consolidated report and an individual entity report in the same file. Parent companies with subsidiaries must fill in the template twice — separately.

~

Excel-inherent limitations

No multi-select dropdowns (implemented as multiple checkboxes instead). Limited accessibility. Security warnings from GPS web service. File easily corrupted by modifying named ranges or formulas.

~

No end-user support

EFRAG provides no hotline or warranty. Issues are raised via GitHub. A technical FAQ covers template functions but not VSME content questions.

~

Fixed report formatting

The Inline XBRL report generated by the converter has a fixed layout. No customisation of design, branding or structure is possible.

These are not criticisms — they are design choices consistent with EFRAG’s stated objective of providing a free starting point to stimulate commercial development. The template demonstrates what VSME reporting looks like. It does not deliver a production-grade reporting workflow.

Free template vs platform-based solution

The gap between the Digital Template and what operational VSME reporting requires becomes clear when you compare feature by feature.

Capability
EFRAG Digital Template
Platform-based solution
Year-on-year comparison
First year only
Automatic roll-forward
Multi-entity reporting
One entity per file
Consolidated + individual
Validation and checks
Built-in formulas
Real-time + cross-field
XBRL output
Via external converter
Integrated export
Cross-framework mapping
VSME only
ESRS, SFDR, GRI
Portfolio-level aggregation
Single entity
Hundreds of entities
Collaborative workflow
Email-based file sharing
Role-based access, audit trail
Support
GitHub issues only
Dedicated support
Cost
Free
$ Subscription

For a micro-undertaking reporting for the first time with minimal data requests, the free template is a perfectly adequate starting point. For any company that needs to report across multiple periods, consolidate subsidiaries, map data to additional frameworks, or manage reporting as an institutional process rather than a one-off exercise, a platform-based solution is the practical choice.

The XBRL taxonomy: what data users need to know

The VSME XBRL Taxonomy is the invisible layer that makes structured data exchange possible. Unlike ESRS Set 1, which requires manual “tagging” of human-readable disclosures, the VSME taxonomy acts as a template — each datapoint maps to a named XBRL element, and the conversion from Digital Template to XBRL report is fully automatic. No additional tagging effort is required from the preparer.

The taxonomy is maintained by EFRAG and available as a free, open XBRL Taxonomy Package. It supports multiple output formats: Inline XBRL (human- and machine-readable HTML), XBRL-XML, XBRL-JSON and XBRL-CSV. For institutions receiving VSME data from SME counterparts, this means the data arrives in a structured, vendor-independent format that can be imported directly into databases, risk systems or regulatory reporting tools.

EFRAG plans to provide guidance on taxonomy extensions, enabling banks and jurisdictions to add institution-specific or country-specific disclosure requirements on top of the base VSME taxonomy. A distribution mechanism for making digital VSME reports available to interested repositories is under consideration for 2026.

What comes next

EFRAG has committed to maintaining the Digital Template, XBRL Taxonomy and converter through at least the end of 2026. Planned enhancements include XBRL Formula validation rules (to enforce completeness checks in any XBRL software, not just the Excel template), digital signatures for entity verification, and guidance on connecting to filing repositories. A future update will also be required when the voluntary delegated act based on the VSME is adopted by the European Commission.

For organisations planning their VSME implementation, the template is a useful reference for understanding the data structure and disclosure requirements. For production reporting — especially at scale — at Generation Impact Global we build on the same XBRL taxonomy to deliver a platform that handles the comparative periods, multi-entity consolidation, cross-framework mapping and workflow management that the template does not.

See production-grade VSME reporting

Same XBRL taxonomy, built for operational use — year-on-year tracking, multi-entity support, real-time validation, and integrated ESRS/SFDR/GRI mapping.

Request a demo

Frequently asked questions

Is the EFRAG Digital Template free to use?

Can the template handle year-on-year reporting?

What entity identifiers does the template support?

Can commercial platforms build on the XBRL taxonomy?

How long will EFRAG maintain the template?

Related news