> 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/english-documentation/variables-templates.md).

# Variables & templates

## Variables

In all fields of the bulk generators you can use **variables**. When generating, they are replaced per product/category with the respective value. The syntax follows Twig:

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

Variables can be inserted conveniently via the **"Possible variables" select** next to each field.

### Important product variables (article & image bulk)

| Variable                                                                                         | Meaning                                                    |
| ------------------------------------------------------------------------------------------------ | ---------------------------------------------------------- |
| `{{ product.translated.name }}`                                                                  | Product name (translated, with fallback) – **recommended** |
| `{{ product.productNumber }}`                                                                    | Product number                                             |
| `{{ product_manufacturer.translated.name }}`                                                     | Manufacturer name                                          |
| `{{ product.ean }}`                                                                              | EAN                                                        |
| `{{ product.weight }}` / `{{ product.width }}` / `{{ product.height }}` / `{{ product.length }}` | Dimensions/weight                                          |
| `{{ product.variation.0.group }}`                                                                | Variant group (e.g. "Color")                               |
| `{{ product.variation.0.option }}`                                                               | Variant value (e.g. "Red")                                 |
| `{{ product.properties.0.name }}`                                                                | Property value                                             |
| `{{ product.properties.0.group.name }}`                                                          | Property name                                              |

### Important category variables (category bulk)

| Variable                         | Meaning                                      |
| -------------------------------- | -------------------------------------------- |
| `{{ category.translated.name }}` | Category name (translated) – **recommended** |
| `{{ category.name }}`            | Category name (raw)                          |
| `{{ category.keywords }}`        | Keywords of the category                     |

> **Recommendation:** always use the `translated` variant (e.g. `product.translated.name`). It returns the translated value **including a fallback** to the default language. The raw field (`product.name`) can be empty if no translation is maintained for the current language.

## Google preview

As soon as a category in the tree is clicked/ticked, the **Google preview** on the right shows how the result looks for a sample product of the category. Requirement: the respective field is filled with a template and activated.

## Templates

Frequently used combinations can be saved as a **template** and loaded again later.

* **Load template** – dropdown above the fields; the saved values, options and categories are applied.
* **Save template** – updates the currently loaded template.
* **Create template** – creates a new template under the entered name.

When saving, the following is stored:

* the **field contents** (title/description/keywords or alt/title),
* the selected **options** (overwrite, subcategories, variants, counter, all languages),
* the **selected categories**,
* the **cron job status** (see [Cron job / automation](/seo-ultimate/english-documentation/cronjob.md)).

### Predefined templates

The plugin ships ready-made templates with the prefix **`[SEO]`** whose name directly shows the structure, e.g.:

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

They appear in the respective bulk (filtered by type) in the "Load template" dropdown and can be used directly or as a starting point.
