> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dc.ag/llms.txt
> Use this file to discover all available pages before exploring further.

# Text Modules

> Edit predefined texts for system emails and shop messages.

Text modules are a fixed set of predefined texts for the shop's **emails** and **system messages**. You do not create new ones; instead, you adapt the existing ones to your brand and tone.

<Info>
  This feature is only available if you are also using **dynamic commerce**.
</Info>

## What text modules are used for

| Area                 | Examples                                                                              |
| -------------------- | ------------------------------------------------------------------------------------- |
| Transactional emails | Order confirmation, access credentials, document copy, welcome email, digital voucher |
| Shop messages        | Empty cart, no search results, failed payment, order completed                        |

The shop automatically accesses the relevant text module at the appropriate point, e.g. the order confirmation after a purchase or the "Cart empty" message on the empty cart page.

## Text modules list

Open **Administration → Text Modules**. For each entry, the list shows:

* **company**: Tenant (e.g. MASTER)
* **Code**: Technical identifier. The suffix indicates the language (`-DEU` = German, `-ENU` = English)
* **Description**: Subject or title of the text
* **File Attachment 1** / **File Attachment 2**: Whether an attachment is stored (Yes/No)

<Note>
  There is no **New** button. The set of text modules is predefined; you can only **edit** the texts. Use **Search** to quickly find a module.
</Note>

## Editing a text module

Select an entry and click **Edit**. The dialog contains:

* **Code**: Identifier of the module (fixed, cannot be changed)
* **Editor**: Rich text editor for the content, with formatting, links, images and tables, as well as the **dc Copilot** for AI support

### Placeholders

The text contains placeholders that are automatically filled at runtime, e.g. `%billToName%` for the name or `%orderDate%` for the order date.

<Warning>
  Leave placeholders such as `%billToName%` unchanged. If you write them incorrectly or delete them, the value will no longer be inserted into the email.
</Warning>

Save via **Save** or **Save and close**.

## File attachments

Using **File Attachment 1** and **File Attachment 2**, you attach files to a text module, e.g. terms and conditions or a PDF for the order confirmation. In the panel, you can **upload**, **download** or **delete** a file, by clicking or via drag-and-drop.

Allowed formats: `.jpg`, `.jpeg`, `.gif`, `.png`, `.pdf`, `.doc`, `.docx`, `.txt`, `.xls`, `.xlsx`, `.csv`, `.rtf`, `.zip`, `.rar`.

## Related topics

<CardGroup cols={2}>
  <Card title="Text Constants" icon="font" href="/docs/en/dynamic-content/user-guide/textkonstanten">
    Maintain recurring short texts per language.
  </Card>

  <Card title="Languages" icon="language" href="/docs/en/dynamic-content/user-guide/sprachen">
    Manage language versions of the website.
  </Card>
</CardGroup>
