> 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 SEO analysis shows no results / “Analyze now” does nothing

The analysis runs **asynchronously** via the message queue. A **message consumer/worker** must be running. Without a worker the run is not processed. Alternatively trigger it manually:

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

## The SEO analysis shows “0 existing metadata” although metadata is maintained

Metadata is stored **per language**. Check the **language selector** at the top of the SEO analysis and switch to the language in which the metadata is maintained.

## Does the SEO analysis include Google PageSpeed?

No. The performance values (load time, page size) come from the built-in sitemap crawl; an integration with Google PageSpeed Insights is not included.

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