> For the complete documentation index, see [llms.txt](https://docs.hubyte.de/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.hubyte.de/seo-ultimate/variablen-templates.md).

# Variablen & Vorlagen

## Variablen

In allen Feldern der Bulk-Generatoren kannst du **Variablen** verwenden. Sie werden beim Generieren pro Artikel/Kategorie durch den jeweiligen Wert ersetzt. Die Syntax entspricht Twig:

```twig
{{ product.translated.name }}
```

Variablen lassen sich bequem über das **Auswahlfeld „Mögliche Variablen"** neben dem jeweiligen Feld einfügen.

### Wichtige Produkt-Variablen (Artikel- & Bilder-Bulk)

| Variable                                                                                         | Bedeutung                                             |
| ------------------------------------------------------------------------------------------------ | ----------------------------------------------------- |
| `{{ product.translated.name }}`                                                                  | Produktname (übersetzt, mit Fallback) – **empfohlen** |
| `{{ product.productNumber }}`                                                                    | Produktnummer                                         |
| `{{ product_manufacturer.translated.name }}`                                                     | Herstellername                                        |
| `{{ product.ean }}`                                                                              | EAN                                                   |
| `{{ product.weight }}` / `{{ product.width }}` / `{{ product.height }}` / `{{ product.length }}` | Maße/Gewicht                                          |
| `{{ product.variation.0.group }}`                                                                | Variantengruppe (z. B. „Farbe")                       |
| `{{ product.variation.0.option }}`                                                               | Variantenwert (z. B. „Rot")                           |
| `{{ product.properties.0.name }}`                                                                | Ausprägung einer Eigenschaft                          |
| `{{ product.properties.0.group.name }}`                                                          | Eigenschaftsname                                      |

### Wichtige Kategorie-Variablen (Kategorie-Bulk)

| Variable                         | Bedeutung                                 |
| -------------------------------- | ----------------------------------------- |
| `{{ category.translated.name }}` | Kategoriename (übersetzt) – **empfohlen** |
| `{{ category.name }}`            | Kategoriename (roh)                       |
| `{{ category.keywords }}`        | Keywords der Kategorie                    |

> **Empfehlung:** Nutze immer die `translated`-Variante (z. B. `product.translated.name`). Sie liefert den übersetzten Wert **inkl. Fallback** auf die Standardsprache. Das rohe Feld (`product.name`) kann leer sein, wenn für die aktuelle Sprache keine Übersetzung gepflegt ist.

## Google-Vorschau

Sobald eine Kategorie im Baum angeklickt/angehakt ist, zeigt die **Google-Vorschau** rechts, wie das Ergebnis anhand eines Beispiel-Produkts der Kategorie aussieht. Voraussetzung: Das jeweilige Feld ist mit einem Template gefüllt und aktiviert.

## Vorlagen (Templates)

Häufig genutzte Kombinationen lassen sich als **Vorlage** speichern und später wieder laden.

* **Template laden** – Dropdown über den Feldern; die gespeicherten Werte, Optionen und Kategorien werden übernommen.
* **Template speichern** – aktualisiert die aktuell geladene Vorlage.
* **Template erstellen** – legt unter dem eingegebenen Namen eine neue Vorlage an.

Beim Speichern werden mitgespeichert:

* die **Feldinhalte** (Titel/Description/Keywords bzw. Alt/Title),
* die gewählten **Optionen** (Überschreiben, Unterkategorien, Varianten, Zähler, alle Sprachen),
* die **ausgewählten Kategorien**,
* der **Cronjob-Status** (siehe [Cronjob / Automatisierung](/seo-ultimate/cronjob.md)).

### Vorgefertigte Vorlagen

Das Plugin bringt fertige Vorlagen mit dem Präfix **`[SEO]`** mit, deren Name direkt den Aufbau zeigt, z. B.:

* `[SEO] Artikel: Name`
* `[SEO] Artikel: Name | Hersteller`
* `[SEO] Artikel: Name (Artikelnr.)`
* `[SEO] Kategorie: Name`
* `[SEO] Bild: Produktname`
* `[SEO] Bild: Produktname + Hersteller`

Diese erscheinen im jeweiligen Bulk (nach Typ gefiltert) im „Template laden"-Dropdown und können direkt genutzt oder als Ausgangspunkt angepasst werden.
