---
title: "Tagging a Document"
description: "Lucanet's XBRL Tagger allows individual words or sentences, values, and entire chapters and tables of a document to be tagged."
source_url: https://support.lucanet.cloud/en/documentation/xbrl-tagger/xbrl-document/xbrl-tag-document
language: en
last_updated: 2023-08-16
---
# Tagging a Document

## Overview

**Lucanet's XBRL Tagger** allows individual words or sentences, values, and entire chapters and tables of a document to be tagged.

## Tagging a Document

The XBRL Tagger allows the following elements of a document to be tagged:

- Texts
- Tables
- Values in tables

In principle, you can tag the elements of a document as follows:

{% stepper %}
{% stepper-step %}
Select the element you want to tag in the **Document** area.
{% /stepper-step %}
{% stepper-step %}
Search for the desired tag in the **taxonomy**.
{% /stepper-step %}
{% stepper-step %}
Drag and drop the tag onto the chosen element.
{% /stepper-step %}
{% stepper-step %}
If necessary, edit the **properties** of the tag (see [Displaying and Editing Properties of a Tag](https://support.lucanet.cloud/en/documentation/xbrl-tagger/xbrl-document/edit-tag-properties.md)).

{% /stepper-step %}
{% /stepper %}
Tagging a text block

After successfully tagging, the tagged element is highlighted in color (see [Status of Tags](https://support.lucanet.cloud/en/documentation/xbrl-tagger/xbrl-document/tag-status.md)).

{% info-box %}
**In-tool validations**: In addition to the properties of tags, the results of **in-tool validations**–validations performed while editing a document – are displayed in the **Properties** area. This feature allows you to respond and correct any tagging errors immediately.

More information can be found under [Validations](https://support.lucanet.cloud/en/documentation/xbrl-tagger/xbrl-document/validation_xbrltagger.md).
{% /info-box %}

{% info-box %}
**Tags and placeholders for tags** that you have created in the [Lucanet Disclosure Management](https://support.lucanet.cloud/en/documentation/disclosure-management.md) solution are transferred to the XBRL Tagger and can be further edited there. You can find information on tagging Word documents in our Disclosure Management solution in [Using the XBRL Tagger](https://support.lucanet.cloud/en/documentation/disclosure-management/xbrl-window.md).
{% /info-box %}

## Linkbases

The three tabs in the [Search options](#search) area contain what are referred to as **linkbases**. Linkbases contain all tags defined in the chosen taxonomy and show, in particular, the relationships between the tags.

Linkbases in the 'Taxonomy' area

Which linkbases are displayed depends on the chosen taxonomy. The following linkbases, for example, are displayed in the ESEF taxonomy:

- **Presentation**: contains the structure of the elements of the chosen taxonomy that you can use to tag the document currently loaded.
- **Calculation**: shows how the elements of the taxonomy are calculated. Summands used in other tables of the report are highlighted and can be opened directly (see the following section _Cross-Table Tag Navigation in the Calculation View_).
- **Definition**: contains the logical relationships between elements of the taxonomy.

## Cross-Table Tag Navigation in the Calculation View

When you open a calculation in the **Calculation** linkbase, the XBRL Tagger shows which summands are also used in other tables of the same report. This makes cross-table tag relationships visible at a glance and helps you spot potential tagging errors or inconsistencies quickly.

### Visual Highlighting

Summands that are used in another table of the report are highlighted with a light red background and a red info icon next to the label. Summands that are used only in the current table are not highlighted.

{% info-box %}
The highlighting applies **only to summands**. Superordinate calculation items and totals are not highlighted, even if they are used in other tables.
{% /info-box %}

### Navigating to Another Table

Click the info icon or the highlighted summand label to navigate directly to the first other table where the same tag is used. The following steps are performed:

- The calculation view of the target table is opened.
- The corresponding cell is selected.
- If the **Properties** area is open, it shows the properties of the selected cell.

### Tagging Texts and Text Blocks

{% info-box %}
Tagging text and text blocks is done in the text content layer. Before tagging text and text blocks, switch to the **Text Tagging** tab at the top of the document area. For more information, see [Working with layers](https://support.lucanet.cloud/en/documentation/xbrl-tagger/xbrl-document/xbrl-tag-document/using-layer.md).

Open the text tagging layer
{% /info-box %}

**ESEF** may require the marking of individual words or sentences (referred to as **text** in the following) (e. g. headquarters of the company = **DomicileOfEntity**) and the marking of text blocks (e. g. specification of liabilities \[text block\] = **DisclosureOfBorrowingsExplanatory**). The tags are of different types (text and text block) and have different icons in the ESEF taxonomy in the XBRL Tagger:

| Element | Description |
|---------|---------|
| Text block | Text block tags are used to mark **large quantities of information**, such as notes and accounting guidelines including tables. Text blocks are intended for paragraphs or areas that cover several pages. |
| Text | Text tags (strings) are used to tag **brief information**, for example something like **Country of Incorporation** or **Name of Reporting Entity**. |

{% info-box %}
- To tag texts or text blocks from [Disclosure Management](https://support.lucanet.cloud/en/documentation/disclosure-management.md), they must be defined as so-called **content controls**. You can define content controls in MS Word on the **Developer tab**.
- If the **Developer** tab is not displayed in MS Word, you need to activate the tab. In MS Word, select **File | Options | Customize Ribbon**, and activate the checkbox of the **Developer** tab under **Main Tabs**.
{% /info-box %}

To tag text or text blocks, you have to mark the desired content control in the Word document and then drag the desired tag from the taxonomy and drop it onto the selected part.

In other documents, you can select a text section and then drag and drop the desired tag from the taxonomy onto the selected area.

### Tagging Tables

{% info-box %}
Tables are tagged at the table level. Before tagging tables, switch to the **Table Tagging** tab at the top of the document area. For more information, see [Working with Levels](https://support.lucanet.cloud/en/documentation/xbrl-tagger/xbrl-document/xbrl-tag-document/using-layer.md).

Open the table tagging layer
{% /info-box %}

Tables are tagged by dragging the desired tag onto the placeholder for the table tag. In all tables, the placeholder can be found in the top, right corner and shows the entry **Drag and Drop here**:

Placeholder for the table tag

Tables are tagged with what is referred to as an **abstract**.

**Example**: A table that displays the cash flow statement is tagged with the tag **ifrs-full:StatementofCashFlowsAbstract**.

Table with the cash flow statement and the corresponding tag

**Changing the Row Order of a Table**

You can adjust the order of the table rows as follows:

{% stepper %}
{% stepper-step %}
Click the **Row Order** button above the document. The following dialog is displayed:

Dialog 'Table Row Order'
{% /stepper-step %}
{% stepper-step %}
In the **Select Table** drop-down list, select the table in which you want to change the row order.
{% /stepper-step %}
{% stepper-step %}
Change the row order in the **Table Row Order** dialog using drag and drop.
{% /stepper-step %}
{% stepper-step %}
Click **Save**.
{% /stepper-step %}
{% /stepper %}

{% info-box %}
You can also reset the row order to the base taxonomy by clicking the button **Use Row Order of the Base Taxonomy**.
{% /info-box %}

{% warning-box %}
To apply the changes to the row order when generating a document, please make sure to save the document by clicking **Save document** before generating.
{% /warning-box %}

### Tagging Values in Tables

A value or several values in a table can be tagged also simply by means of drag-and-drop. As soon as a tag from the XBRL taxonomy has been identified that is suitable for the table cell or table cells chosen in the document, the tag can be dragged from the **Taxonomy** area and dropped onto the value selected in the table.

Tagging a value

The cells are marked in green as soon as the tagging was successful.

The tagging details of values can be checked and/or changed by clicking a cell in the Properties area (see [Displaying and Editing Properties of Tags](https://support.lucanet.cloud/en/documentation/xbrl-tagger/xbrl-document/edit-tag-properties.md)).

{% idea-box %}
**Tip**: In tables, you can define properties for all values at once by selecting the table completely and defining the desired configuration under **Properties**. The configuration of the properties will then apply to all values of the table.
{% /idea-box %}

### Member Tagging

Tables for which the items are broken down into columns and rows require both **line item tags** to tag the row and **tags for columns** (= member tags). Member tags are displayed in the ESEF taxonomy by a special icon and contain the label in the suffix **\[Member\]**.

Proceed as follows:

{% stepper %}
{% stepper-step %}
**Specifying a line-item element**: First select the **rows**, choose the desired element from the XBRL taxonomy, and drag it into the selected column.
{% /stepper-step %}
{% stepper-step %}
**Specifying member elements**: Then select the **column** to be tagged, choose the desired element from the XBRL taxonomy and drag it into the selected column.

{% /stepper-step %}
{% /stepper %}
{% info-box %}
You can tag a single cell in a table or several cells at the same time. The following options are available for tagging several cells in a document at the same time:

- Select the desired cells while **holding down the left mouse button**.
- Use the arrow keys on your keyboard while holding down the **SHIFT** key to choose several cells.
- **Select non-adjacent cells**: Hold down the **CTRL** key and left click on each cell to be included in the selection.
- **Select adjacent cells**: Select the first cell to be included in the selection and then hold down the **SHIFT** key. While holding down the **SHIFT** key, click the last cell to be included in the selection.
{% /info-box %}

With the [ESEF](https://support.lucanet.cloud/en/documentation/glossary.md#esef), the only use case for member tagging is the tagging of the table **Statement of changes in equity**. After successfully tagging, the element receives two tags (one **line item tag** and one **dimension tag**).

Line item tag and dimension tag for a value in the statement of changes in equity

In contrast, tables in which the column headers contain a period (e. g. **2022** and **2024**) are each tagged with the same tag, which then varies only in terms of the period.

### Tagging as Addition in Parentheses

Facts that belong to a table, but are not physically part of it, (e. g. if a number that belongs to a table is used in continuous text) can be marked as what are referred to as **additions in parentheses**, i. e. as additional information appended to the table. This information must also be disclosed.

To tag an element (e. g. a value) as an addition in parentheses:

{% stepper %}
{% stepper-step %}
Select the desired value with a **content control element** when preparing the Word document before loading it to the XBRL Tagger.

{% /stepper-step %}
{% stepper-step %}
Select the desired value in the document.
{% /stepper-step %}
{% stepper-step %}
Tag the value by means of drag-and-drop with the desired tag.
{% /stepper-step %}
{% stepper-step %}
The tagged element must then also be tagged to the table to which it belongs. To do so, tag the value with the table tag, i. e. with the **Abstract** tag of the table to which the value belongs.

{% /stepper-step %}
{% /stepper %}
{% warning-box %}
- You can insert content control elements either directly in MS Word or alternatively in the [Disclosure Management](https://support.lucanet.cloud/en/documentation/disclosure-management.md) solution (see [Inserting XBRL Tags](https://support.lucanet.cloud/en/documentation/disclosure-management/work-with-msoffice/configure-word-file/word_add_xbrltags.md)).
- You can find information on content control elements in MS Word also here: [About content controls - Microsoft Support](https://support.microsoft.com/en-us/office/about-content-controls-283b1e29-0b77-4781-b236-2d02c1cce1c2?ns=WINWORD&version=90)
{% /warning-box %}

## Copying and Pasting Tags

Tags can be copied in the document and inserted else where. Proceed as follows:

{% stepper %}
{% stepper-step %}
Select a tagged element in the document.
{% /stepper-step %}
{% stepper-step %}
Open the context menu of the element and choose the **Copy** command.

Copying a tag

{% /stepper-step %}
{% stepper-step %}
Select an element and choose **Insert** from the context menu. The tag is inserted together with all properties and the current status.

{% /stepper-step %}
{% /stepper %}
## Additional Functions

The following additional functions are available for the taxonomy and the elements it contains:

### Filtering the Taxonomy

To quickly find the suitable tag, the taxonomy can be filtered by certain criteria. Click , to open the search options:

Search options for taxonomy

The following filters are available:

- **Exact match**: filters tags that match the exact term entered under **Search** and contain only it, for example the search term **Assets** finds only **ifrs-full:assets**.
- **Abstracts only**: shows **abstracts** that contain the search term.
- **Item types**: filters the search results by the chosen **element types**. As soon as you activate the option, you can select the desired element types in the displayed list.

### Displaying References

As soon as you select an element in the taxonomy, the references of the selected tag are displayed in the **Properties** area:

Display references of a taxonomy element

### Displaying Tagged Items

To quickly find out if and where a tag has been used in the document, you can open the **Tagged items** drop-down list in the **Properties** area and identify the locations of the tag's usage in the document.

Display tagged items