# Add your own content to Shopware: setup manual · Stone & Water > Manual for the AI content blocks: creating blocks, areas and positions, content with Twig and AI, controlling visibility, and the output modes. Quelle / Source: https://stoneandwater.online/en/manual-ai-content-blocks.html # AI content blocks manual. From the first block to the awkward case: know the positions, create content with Twig and AI, control visibility - and know what to do when a theme gets in the way. [To the product page](https://stoneandwater.online/en/ai-content-blocks.html)[Get in touch](https://stoneandwater.online/en/contact.html) #### Contents / ## System requirements Shopware 6.7 with Storefront, PHP 8.2 or newer. For AI generation you need your own API key with OpenAI, Anthropic, Google or Mistral; billing happens directly there. **Usable without AI:** blocks can be maintained entirely by hand. The AI part is a convenience, not a requirement. ## Installation Upload the ZIP in the admin under Extensions, install and activate it. Then enter the licence key on the licence screen. The module is reachable through the Plugin Suite and additionally under Settings. ## Your first block in four steps - Click "Create block" in the module - Choose the area, then the position within it - Enter the content or have the AI write it - Save and activate The block appears in the shop straight away. Clearing the cache is usually not necessary. ## Areas and positions The 52 positions are grouped into areas. You pick the area first, then the position within it - that keeps the list manageable. - **Head and scripts** - at the very top of the head, at the end of the head and right after the body starts; written into the page independently of the theme - **Detail page** - around name, article number, price, tax, delivery information, variant selection, buy button, wishlist, gallery, reviews and cross-selling, plus four points around the description text - **Category and search** - top and bottom of the category, in the listing, above the filter, top and bottom of the search results - **Basket and checkout** - basket page, off-canvas basket, confirmation page before payment method and before submitting, address page, thank-you page - **Account and wishlist** - customer account, registration, wishlist - **Header and footer** - top and bottom of the header, top and bottom of the footer, below the copyright line - **Content area** - two positions that apply on every page, at the very top and the very bottom **On the content-area positions:** they suit notice bars that really should appear on every page. Because they apply everywhere, mistakes there show up everywhere too - when setting one up, narrow it down with a device selection or a time window first. ## Limit to page types Besides sales channel, device and time window, a block can be limited to individual page types. Without a selection it still appears everywhere, otherwise only on the selected ones. - Home page - Category page - Product detail page - Search results - Shop pages and layouts - Cart - Checkout and confirmation - Customer account - Wishlist **How it combines with positions:** the page type applies on top of the position. A block in the content area limited to the home page therefore appears there only, even though the position itself would apply on every page. ## Content, CSS and JavaScript Every block carries three fields: the content, its own CSS and optionally its own JavaScript. Everything hangs off the block - delete it and the extras go with it. All three fields accept Twig expressions and Shopware variables. Available at every position are: the product (on the detail page), the context, the sales channel, the currency and the customer. **Example:** `{{ product.name }}` in the content inserts the article name, `{{ context.currency.symbol }}` the currency symbol. That allows a notice that names the article being viewed. The content is stored per language. A block can read differently in the German channel than in the English one, without maintaining two blocks. ## Letting the AI write the content In the block window you describe in one sentence what the block should show. One button, and the AI delivers content, CSS and JavaScript together. The instruction is stored on the block and shown again the next time you open it. That allows refining instead of rewriting from scratch every time. **Images as a template:** up to four images can be attached - a draft, a screenshot of the look you want, or an example from another site. The AI rebuilds the block from them. **On the key:** provider, key and model live in the Settings tab, along with a connection test. The key is stored server side and never delivered to the browser. ## Who sees the block **Sales channel:** a block applies to one channel or to all of them.**Articles:** four routes are available - all articles, a list of article numbers, a dynamic product group or selected categories. Article numbers can be pasted as a list. **Detail page only:** the article assignment takes effect where there is an article. In other areas - the header or the checkout, for instance - it is hidden, because it could not narrow anything down there. **Device:** mobile, tablet, desktop or combinations, selectable per block.**Period:** a block can appear from one date and disappear on another. Without a setting it applies indefinitely.**Order:** when several blocks sit at the same position, the priority decides the sequence. ## Output mode Normally the block is inserted at its position while the page is being built. That is the clean route and the default. Some themes replace the same Twig blocks this plugin uses. The content would then never arrive. For that case a second output mode places the block by script instead. **Try the default first:** the second mode is the fallback. It can be set globally and additionally chosen per block, so the exception stays an exception. ## Managing many blocks The block list filters by area and shows 25 entries per page. Multi-select allows activating, deactivating or deleting several blocks together. Deactivating takes the block out of the shop without losing it - useful for campaigns that return later. ## Troubleshooting **The block does not appear:** check in order: is it active? Does the sales channel match? Is today within the time window? Does the device selection match your test device? And for detail page blocks: is the article being viewed actually assigned? **It appears in the wrong place or not at all although everything fits:** your theme probably replaces the same Twig block. Switch the output mode of the block to the second mode. **The CSS has no effect:** themes often set their own rules with higher specificity. Write the rule more narrowly, for example through a class of your own in the block content. ## Support Questions and requests come straight to us - support is from the developer, not from a queue. You can also request a feature through the Plugin Suite in the admin. ## All settings Every setting of the plugin with its default value and explanation, in the same order as in the administration. The texts come straight from the plugin (version 1.33.1). ### Sales channel Defines which sales channel the settings apply to. Without a selection they apply to all. **Sales channel** Default: All sales channels All further settings on this page apply to the channel selected here. ### Output Determines how the blocks reach the page. **Output mode** Default: Through the templates Through the templates is the default. If a theme replaces the same Twig blocks, the script output can help. ### AI interface Store provider, key and model here. If no key is set, the plugin falls back to the credentials of the AI product advisor. **Provider** Default: Google Gemini Which company supplies the language model. The choice determines the available models. **API key** Default: empty The access key of the provider. It is stored encrypted and never output in the storefront. **Model** Default: Gemini 3.8 Flash (neu, empfohlen) The language model in use. Smaller models answer faster, larger ones write more carefully. **Check connection** Default: - Sends a short request to the provider and reports whether access and model are correct. ### Transfer blocks Saves all blocks to a file and reads them back in another shop. **Save and import** Default: - On import the blocks are created anew, existing ones remain unchanged. ### Creating and editing blocks A block without a sales channel applies to all shops. A block with a sales channel replaces the general block at the same position. Product custom fields exist only for blocks on the detail page. **Name** Default: empty Internal name of the block for the overview. It only helps to find your way around the block list. **Sales channel** Default: All sales channels A block without a sales channel applies to all shops. A block with a sales channel replaces the general block at the same position. Product custom fields exist only for blocks on the detail page. **Area** Default: Product detail page The area of the page where the block appears: free position with its own CSS selector, design (CSS), head and scripts, detail page, header, footer, category, search results, wishlist, customer account, cart and checkout, or content area. It determines which positions are available. **Position** Default: Below the reviews The exact spot within the area, on the detail page for example above the price, below the add-to-cart button or at the end of the description. The list depends on the chosen area. **CSS selector** Default: empty The block is attached to the first matching element in the browser. Example: .product-detail-buy or #myArea **Placement** Default: Before Where the block goes relative to the matched element: before, after, at the start inside or at the end inside. Only with a custom CSS selector. **Priority** Default: 0 Order when several blocks share the same position. The lower number is output first. **Output mode** Default: As set in the settings By default the blocks are rendered through the templates. If a theme replaces the same Twig blocks without parent(), they will not appear. In that case choose the script output, which places them at fixed anchor points in the browser. **Status** Default: active Switches the block on or off. Inactive blocks stay stored but do not appear in the shop. **Visibility** Default: On all products Defines whether the block runs on all products or only where it was switched on for the product. **Devices** Default: All devices Shows or hides the block depending on screen width. Mobile up to 767 pixels, tablet up to 991 pixels, desktop above. **Pages** Default: All pages Without a selection the block appears on all pages. Otherwise only on the selected ones. **Products** Default: none The block runs on all products. Products assigned here can get different content or be switched off. The block only runs on products assigned here or matching the product group or category. **Language** Default: - Several languages possible. Content is written for all selected ones, the highlighted chip marks the language being edited. **HTML content** Default: empty May stay empty if only CSS or JavaScript is needed. Twig is allowed. Always available are context, salesChannel, currency and customer, on the detail page also product, in the page areas page. **Custom CSS** Default: empty In the styling area the CSS applies to the whole page, otherwise with the block. The HTML field may stay empty, then only the CSS applies, for example to hide existing elements. Selector for this block: **Custom JavaScript** Default: empty Runs right after the block. Only the code, the plugin adds the script tag. A complete tag with src is taken as is. **Show from** Default: empty Leave empty for permanent display. With page caching enabled the change may appear slightly delayed. **Show until** Default: empty Leave empty for permanent display. With page caching enabled the change may appear slightly delayed. **Preview** Default: - Twig expressions are filled with sample values here. The shop shows the real data. ## Availability Directly from Stone & Water ### Available now Monthly 24,99 € Best value Yearly 254,90 € 15 % cheaper All prices net, plus VAT. You buy the licence directly from us and receive an invoice from us. Installation by upload in the admin without SSH, updates through our licence platform, support straight from the developer. [Get in touch](https://stoneandwater.online/en/contact.html)[+49 2555 9997342](tel:+4925559997342) Shopware Store ### In preparation The plugin will be listed in the official Shopware Community Store. Installation and automatic updates then run through the plugin manager in the backend, billing through your Shopware account. We will link it here as soon as it is available. [Image: Stone & Water] Shopware e-commerce agency from Schöppingen, Germany. Consulting, implementation and optimisation - from the first concept to long-term growth. ### Shopware - [Shopware overview](https://stoneandwater.online/en/shopware.html) - [Migration (5 to 6)](https://stoneandwater.online/en/shopware-migration.html) - [SEO optimisation](https://stoneandwater.online/en/shopware-seo.html) - [Performance](https://stoneandwater.online/en/shopware-performance.html) - [Template development](https://stoneandwater.online/en/shopware-template-development.html) - [Plugin development](https://stoneandwater.online/en/shopware-plugin-development.html) - [PIM for Shopware](https://stoneandwater.online/en/pim.html) - [Shopware Plugins](https://stoneandwater.online/en/plugins.html) ### Plugins [Plugin Suite free ](https://stoneandwater.online/en/plugin-suite.html)[All plugins](https://stoneandwater.online/en/plugins.html)[All videos](https://stoneandwater.online/en/videos.html) - [A/B Testing](https://stoneandwater.online/en/ab-testing.html) - [AI Blog & Landing Page](https://stoneandwater.online/en/ai-landingpage.html) - [AI Content Blocks](https://stoneandwater.online/en/ai-content-blocks.html) - [AI Cross-Selling](https://stoneandwater.online/en/ki-cross-selling.html) - [AI Image Badge](https://stoneandwater.online/en/ai-image-badge.html) - [AI Image SEO](https://stoneandwater.online/en/ai-image-seo.html) - [AI Newsletter](https://stoneandwater.online/en/ai-newsletter.html) - [AI Newsletter Agent](https://stoneandwater.online/en/ai-newsletter-agent.html) - [AI Product Advisor](https://stoneandwater.online/en/ki-product-advisor.html) - [AI Product Bundles](https://stoneandwater.online/en/ai-product-bundles.html) - [AI Product Questions](https://stoneandwater.online/en/ki-product-questions.html) - [AI Product Search](https://stoneandwater.online/en/ki-product-search.html) - [AI Product Videos](https://stoneandwater.online/en/ai-product-videos.html) - [AI Translation Manager](https://stoneandwater.online/en/ai-translation-manager.html) - [Category Levels](https://stoneandwater.online/en/category-levels.html) - [CLP Information](https://stoneandwater.online/en/clp-information.html) - [Cross-selling at checkout](https://stoneandwater.online/en/checkout-cross-selling.html) - [Crypto Payment](https://stoneandwater.online/en/crypto-payment.html) - [Customer Reviews](https://stoneandwater.online/en/customer-reviews.html) - [Database Cleanup & Optimizer](https://stoneandwater.online/en/db-cleaner.html) - [Lite YouTube](https://stoneandwater.online/en/lite-youtube.html) - [Live Viewer & Sales Counter](https://stoneandwater.online/en/live-viewer.html) - [Manufacturer Pages](https://stoneandwater.online/en/manufacturer-pages.html) - [Page Speed Optimization](https://stoneandwater.online/en/page-speed.html) - [Payment information on PDF documents](https://stoneandwater.online/en/payment-info-pdf.html) - [Plugin Update Manager](https://stoneandwater.online/en/update-manager.html) - [Read More - Description](https://stoneandwater.online/en/read-more.html) - [robots.txt Manager](https://stoneandwater.online/en/robots-txt.html) - [Shipping Calculator](https://stoneandwater.online/en/shipping-calculator.html) - [Shopping Like Dating](https://stoneandwater.online/en/shopping-like-dating.html) - [Variant preselection](https://stoneandwater.online/en/variant-preselection.html) More plugins [ALBIS Leasing](https://stoneandwater.online/en/albis-leasing.html)[Cache Warmer](https://stoneandwater.online/en/cache-warmer.html)[Shopware CDN](https://stoneandwater.online/en/shopware-cdn.html) ### Company - [Contact](https://stoneandwater.online/en/contact.html) - [Legal notice](https://stoneandwater.online/en/legal-notice.html) - [Privacy](https://stoneandwater.online/en/privacy.html) - Cookie settings © 2026 Stone & Water · Dominic Steiner Hosted on [Creoline](https://www.creoline.com/ref/tYq4UkumEqLtMCi3PpwEJo9JspG66udf) [LinkedIn](https://www.linkedin.com/company/18043592/) · [Xing](https://www.xing.com/pages/stone-water) · [Facebook](https://www.facebook.com/stoneandwateragency/)