Help

Shopware Integration

Connect BlogSEO to your Shopware 6 store to automatically publish AI-generated articles, and to feature your real products inside that content. It connects with a Shopware Integration (an API key pair you create in your own admin), so there is no app to install, no store review, and nothing about BlogSEO ever appears in your storefront. It works on both self-hosted Shopware and Shopware Cloud.

How publishing works

Shopware has no blog built into its core, so BlogSEO publishes to whichever of these two targets fits your store. It detects the right one for you when you connect.

  • OpenBlogware plugin — if you have the free OpenBlogware plugin installed, BlogSEO publishes articles as native blog posts, with an author and cover image, that appear in your theme's blog.
  • Landing-page fallback — if no blog plugin is installed, BlogSEO publishes each article as its own landing page under /blog/{slug}, built from a CMS page (Shopping Experiences) and assigned to your storefront. This needs no plugin and works on any Shopware store.

Either way the article lives on your own domain, not on BlogSEO.

Installing the OpenBlogware plugin (optional)

OpenBlogware is a free, open-source Shopware 6 plugin maintained at github.com/Werkstattl/OpenBlogware. You only need it if you want articles published as native blog posts — without it, BlogSEO uses the landing-page fallback, which works on any store with no plugin.

The fastest way to install it on a self-hosted store is with Composer, from your Shopware project root:

composer require werkl/open-blogware
bin/console plugin:refresh
bin/console plugin:install --activate WerklOpenBlogware
bin/console cache:clear

Alternatively, install it from the Shopware admin:

  • Download the latest release ZIP from the OpenBlogware releases page.
  • In your admin, open Extensions → My extensions → Upload extension and select the ZIP.
  • Click Install, then Activate the plugin.

Always check the OpenBlogware repository for the version compatible with your Shopware release and for the most up-to-date installation steps. After installing, reconnect your store in BlogSEO so it picks up the plugin and switches to publishing native blog posts.

Requirements

Before connecting your Shopware store, make sure you have:

  • A Shopware 6 store (self-hosted or Shopware Cloud), reachable from the public internet.
  • Admin access to create an Integration.
  • At least one storefront sales channel with a domain, so published articles and product links resolve to a real URL.
  • Optional: the OpenBlogware plugin, if you want articles published as native blog posts instead of landing pages.

Creating the Integration in Shopware

BlogSEO authenticates with a Shopware Integration — a key pair you generate in your admin and paste into BlogSEO.

  • In your Shopware admin, open Settings → System → Integrations
    • Click Add integration
  • Name it BlogSEO
  • Enable Administrator access
  • Save, then copy the Access Key ID and Secret Access Key

The Secret Access Key is shown only once, when you create the integration. If you lose it, regenerate the key in Shopware — note that regenerating replaces both values, so you will need to update them in BlogSEO.

Administrator access is the simplest setup and is recommended. If your security policy requires a least-privilege role instead, see Using a restricted role below.

Connecting BlogSEO to Shopware

  1. In your BlogSEO dashboard, go to Integrations → Shopware and click Connect Shopware.
  2. Enter your Shopware store URL (for example https://shop.example.com). BlogSEO checks the URL is a reachable Shopware store as you type.
  3. Paste the Access Key ID and Secret Access Key from the integration you just created.
  4. Click Connect.

When you connect, BlogSEO tests the credentials, detects your publishing target (OpenBlogware or landing pages), and confirms whether your product catalog can be imported. If your store has more than one storefront, you choose which one articles publish to.

Publishing content

You have two options for publishing articles to Shopware:

  1. Auto-publish: enable auto-publish in the Shopware integration settings, and BlogSEO pushes articles to your store as soon as they are generated.
  2. Manual publish: from the dashboard, open a generated article and click Publish → Publish to Shopware.

BlogSEO handles the publishing details for you:

  • Rich text and tables: articles are converted to clean HTML so headings, lists, links, and tables render correctly.
  • Cover image: uploaded to your Shopware media library and attached to the post (OpenBlogware) or featured on the landing page, with alt text. Re-publishing reuses the same image instead of uploading a duplicate.
  • Inline images: uploaded to your Shopware media library and embedded in the article body.
  • SEO and slug: the meta title, meta description, and a custom URL slug are set on each article. You can edit the slug per article before publishing.
  • Updates: editing an article in BlogSEO and re-publishing updates the same post or landing page instead of creating a duplicate.

Draft mode

When draft mode (Publish in draft) is enabled, articles are created inactive in Shopware — an unpublished blog entry or an inactive landing page. You can review them in your Shopware admin and switch them live when ready. Once you publish them in Shopware, BlogSEO reflects the live status automatically.

Products

If your integration can read products, BlogSEO can import your Shopware product catalog so it mentions and hyperlinks your real products inside articles, and features their images in your article visuals.

Each synced product carries its title, description, price, image, product page URL, brand, category, and SKU straight from Shopware. Products you deactivate in Shopware are archived on the next sync, so your catalog stays in step with your store. See the Products feature for how the catalog works, how products are chosen, and how to control which ones get used.

Using a restricted role

Administrator access is recommended and is the simplest setup. If you prefer a least-privilege integration, create a custom ACL role in Shopware (Settings → System → Integrations → your integration → Roles) and grant the privileges for the features you use. The Connect step reports any privilege that is missing, so you can grant exactly what you need.

  • Product import: product:read, product_manufacturer:read, product_media:read, category:read, media:read, seo_url:read, sales_channel:read, sales_channel_domain:read, currency:read, language:read
  • Blog publishing (OpenBlogware): werkl_blog_entry (read/create/update/delete), werkl_blog_author (read/create), media (read/create/update), media_folder:read
  • Blog publishing (landing-page fallback): cms_page, cms_section, cms_block, cms_slot (read/create/update/delete), landing_page (read/create/update/delete), landing_page_sales_channel:create, seo_url (read/create/update), media (read/create/update)

Troubleshooting

Published articles or product links 404 on the storefront

Shopware routes the storefront by sales-channel domain. If a published landing page or product URL does not resolve, the domain BlogSEO publishes to does not match a configured storefront domain. In Shopware, open the sales channel and confirm its Domains include the exact URL your shop is served on (including the protocol and any port), then re-check the storefront.

Connection test fails

  • Check the credentials: paste the Access Key ID and Secret Access Key exactly. Remember that regenerating the key in Shopware replaces both values.
  • Check the URL: enter the store's root URL, reachable from the public internet (BlogSEO's servers connect from outside your network).
  • Privileges: if you use a restricted role rather than Administrator, the test names the privilege your role is missing.

Articles publish as landing pages, but I want native blog posts

Install the free OpenBlogware plugin in your Shopware store, then reconnect your store in BlogSEO. BlogSEO detects the plugin and switches to publishing native blog posts going forward.

Images not appearing

BlogSEO downloads your article's images and re-uploads them to your Shopware media library. If the original image URLs are behind authentication or have expired, the upload is skipped. Re-generate or re-upload the image in BlogSEO and publish again.

Frequently Asked Questions

Do I need to install an app or plugin to connect Shopware?
No. BlogSEO connects with a Shopware Integration, an API key pair you create under Settings → System → Integrations. There is no app to install and no store review. The optional OpenBlogware plugin is only needed if you want articles published as native blog posts rather than landing pages.

Does BlogSEO host my blog, or do I publish to my own Shopware store?
BlogSEO does not host your articles. It writes the content and publishes it into your own Shopware store, either as native blog posts (with the OpenBlogware plugin) or as landing pages under /blog/. The article lives on your domain, not on BlogSEO.

What is the difference between OpenBlogware and the landing-page fallback?
Shopware has no core blog. If the free OpenBlogware plugin is installed, BlogSEO publishes native blog posts that appear in your theme's blog. If no blog plugin is installed, BlogSEO publishes each article as its own landing page under /blog/{slug}, which needs no plugin and works on any store. BlogSEO detects which one to use when you connect.

Does this work with Shopware Cloud, or only self-hosted?
Both. Because BlogSEO connects with an Integration API key rather than an installed app, it works on self-hosted Shopware and on Shopware Cloud.

Can I review articles before they go live on Shopware?
Yes. Enable draft mode (Publish in draft) and articles are created inactive in Shopware, as an unpublished blog entry or an inactive landing page. Review them in your Shopware admin and switch them live when ready. You can also keep Manual publish on to approve each article before it is sent.

Can BlogSEO use my real Shopware products in articles?
Yes. With the Products feature, BlogSEO imports your Shopware catalog and can mention and hyperlink your real products inside articles, and feature their images in your article visuals. You choose which products are eligible.

Will any BlogSEO branding show up in my Shopware store?
No. You create the Integration yourself and name it whatever you like, and BlogSEO publishes content through the API. Nothing about BlogSEO appears in your storefront or admin beyond the integration you created.

A published article or product link returns a 404. What should I check?
Shopware routes the storefront by sales-channel domain. Open the sales channel in Shopware and confirm its Domains include the exact URL your shop is served on, including protocol and any port. A domain mismatch is the most common cause of published pages not resolving.

For additional support, contact our team through the in-app chat or at support@blogseo.io.

Was this page helpful?