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 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