# Frequently asked questions (FAQ)

### I can't see the editing fields – why is that?

The editors only appear **after the document configuration has been saved once**. For a new configuration you will first only see the note "Since this is a new Document please save first." Save the configuration – afterwards the fields are loaded (the page may reload automatically once).

### Which documents does the plugin work with?

With Shopware's standard PDF documents: **invoice**, **delivery note**, **credit note** and **cancellation invoice**. Customization is done per document type under **Settings > Documents**.

### Do my customizations apply to all sales channels/languages?

Content and templates are stored **per language** (see language switcher). The assignment to sales channels is handled via Shopware's own document configuration.

### What happens if I leave a field empty?

Then the respective Shopware standard is used. Examples: an empty footer shows the standard footer; an empty line items table or summary uses Shopware's standard rendering.

### How do I get back to the original layout?

Use the **Load default template** or **Load default CSS** buttons. These restore the bundled, faithful templates. Alternatively, empty the respective field to fall back to Shopware's standard rendering.

### My preview or document fails – what should I do?

Most often there is a Twig syntax error in the customized template (e.g. an unclosed tag). The [preview](/pdf-dokumenten-template-bearbeiten/english-documentation/vorschau.md) shows the concrete error message. Correct the template and try again.

### Will my customizations be overwritten during a plugin update?

No. Your content, styles and templates are stored in the database (`hue_custom_document`) and are preserved during updates. Only when clicking **Load default template** is the respective field deliberately overwritten with the bundled template.

### What happens on uninstallation?

If you select **Keep data** when uninstalling, your customizations are preserved. If you select **Remove data**, the plugin tables are dropped and all customizations are removed irreversibly; Shopware's standard documents apply again.

### I need support with an individual customization.

We are happy to help: [hubyte.de/projekt-anfragen](https://www.hubyte.de/projekt-anfragen)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.hubyte.de/pdf-dokumenten-template-bearbeiten/english-documentation/faq.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.