> 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/faq.md).

# FAQ

## My color changes (footer/header) are not shown

Color and layout changes in the **Conversion & usability** area only become visible after **recompiling the storefront theme**. Recompile the theme and clear the cache if necessary.

## The newsletter area does not appear

For the newsletter banner, a **shop page layout for newsletter pages** must be set under **Settings → Basic information**.

## Social media / header icons are missing

These icons require **Fontawesome**. Enter the **Fontawesome kit code** under **Settings → Plugins → SEO Ultimate**.

## The bulk generator is slow / aborts with many articles

Adjust the **generator block size** in the plugin configuration. Smaller values are gentler on the server, larger values are faster (with sufficient server performance). When in doubt, use `100`.

## The product name is not inserted in the bulk generator

Use `{{ product.translated.name }}` instead of `{{ product.name }}`. The `translated` variant returns the translated value **including a fallback**; the raw field can be empty if no translation is maintained in the current language.

## The preview / category selection stays empty

Click or tick a category in the tree that **directly contains products** (or enable "Generate for all subcategories"). For the preview, a field must also be filled with a template and activated.

## The cron job does not run automatically

Make sure Shopware's **scheduler / message consumer** is running on the server. You can also trigger the task manually:

```bash
bin/console scheduled-task:run-single hueb_seo.bulk_generate
```

## The canonical tag is not rendered

Enter a **full URL** including `https://` in the **SEO canonical** field (product or category SEO tab). If the field is empty, Shopware automatically outputs the default SEO URL as the canonical.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://docs.hubyte.de/seo-ultimate/english-documentation/faq.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
