For the complete documentation index, see llms.txt. This page is also available as Markdown.

SEO analysis

Evaluates the SEO state of your shop and presents the results in clear cards with key figures and linked detail lists.

Open via: Marketing → SEO Ultimate → SEO analysis

Starting an analysis

  • Use the “Analyze now” button (top right) to start a new evaluation.

  • The analysis runs asynchronously in the background (Shopware message queue). Results update automatically once the run has finished.

  • The most recently finished evaluation is always shown, including a timestamp.

Requirement: A running message consumer / worker on the server (usually already set up on production systems). Without a worker the triggered analysis is not processed. Alternatively it runs automatically once a day via the scheduled task.

Language

In Shopware, metadata and image alt texts are translatable. The analysis therefore evaluates each storefront language (from the sales channel domains) separately.

  • If there is more than one language, a language selector appears at the top.

  • By default the language with the most maintained metadata is preselected.

Metadata overview (products & categories)

A separate card each for products and categories with key figures:

  • Total, meta title empty, meta description empty, title too long, description too long.

  • “Too long” means anything above the thresholds defined in the configuration (default: 60 characters title, 160 characters description).

Below that, two lists:

  • Issues – entries with empty or overly long metadata.

  • Existing metadata (character count) – overview of already maintained entries to review the character count. The length is color-coded: green = within the valid range, red = empty or above the threshold.

Every name is linked directly and opens the product or category in the admin. The lists are paginated like the Shopware standard (items per page selectable via dropdown).

Images

  • Media without alt attribute – images without a maintained alt text. If an image is used by a product, the row is linked directly to the product.

  • Images without src attribute<img> tags in the rendered storefront HTML without a src (e.g. pure lazy-load images with data-src). Includes a link to the affected page.

HTTP errors (sitemap crawl)

The analysis fetches the sitemap URLs of all active sales channel domains and checks the HTTP status codes:

  • 404 errors (page not found)

  • 500 errors (server errors)

  • Unreachable (timeout / connection error)

All hits are listed with their URL. The number of crawled URLs is limited via the configuration.

Performance

Useful performance values are derived from the same crawl (no external API required):

  • Avg. load time, median load time, slowest page (server response time)

  • Avg. page size (transfer size)

  • List of the slowest pages with load time and size.

Showing cards on the admin dashboard

Each card has a “Show on admin dashboard” switch in the top right. When enabled, that card (as a compact key-figure summary) appears directly on the Shopware start dashboard – with a link to the full SEO analysis.

The setting applies shop-wide (not per user).

Configuration

Under Settings → Plugins → SEO Ultimate:

  • Meta Title Characters / Meta Description Characters – thresholds for the character counters (green/red).

  • Max. crawled URLs per analysis – upper limit of sitemap URLs fetched during the crawl (default 300). Higher values increase coverage but take longer.

Automation

The analysis also runs automatically once a day via Shopware’s scheduled task system (hueb_seo.analysis).

Trigger manually (for admins/developers):

Registration (in case the task is missing after an update):

Notes

  • PageSpeed: An integration with Google PageSpeed Insights is currently not included; the performance values come from the built-in crawl.

  • Scope: The detail lists are capped per evaluation; the key figures (totals) are complete.

  • Sitemap: The crawl requires a reachable sitemap.xml per domain (Shopware generates it automatically; Shopware serves the partial sitemaps gzip-compressed, which the analysis handles).

Zuletzt aktualisiert