The category administration provides a structured way for hanging your items. Here you can use as many main and subcategories as required, assign headlines and text to each as well as optimise them for search engines.


Category overview

In the left column you'll find the complete category overview, the highlighter (1) shows you, in which category you are working. Inactive categories (2) will be shown in light grey.

Creating a category

If you haven’t already created a category in Shopware and the category tree is empty, you will have to create the main categories.

In the default Shopware installation, the system’s category is named “Shopware”, and the corresponding category is “English”. Click on English (1) on the left and assign the name of the new category in New subcategory (2). Click on Create subcategory (3) to create the new category.

The first level under "English" is your "scaffold" in Shopware and will be shown in your frontend’s main category table (in all default templates and if the categories are active and visible). The root category "Shopware" cannot be used as scaffold for your shop.

The category "English" is your shop’s default homepage. This is important to know when creating banners, defining keywords, descriptions and other SEO relevant content.

After you build the structure of your scaffold, you are able to create additional subcategories within subcategories. When the category is saved, the tab "item mapping" becomes active, which allows you to assign items to your category. After you created a new category, the settings area can be used to assign additional settings that weren’t possible when creating the category structure (i.e. active, filter options, product layout, etc.). When you create a new category, it will always be displayed as a simple category. When you want to move an existing category, you have to manually create a subcategory in order for the category to get a folder icon. Only when your category has a folder icon can you move categories via drag & drop.

Renaming a category

To rename a category, click left on the desired category. This opens the details on the right, where you can rename your category. Don’t forget to save your changes.

Moving categories

If you want to change the category order, you can do this simply using drag & drop. After repositioning your categories, a popup message will appear asking you to confirm your changes. The categories will reposition after you confirm.

In Shopware, you also have the possibility of migrating entire category trees. Doing this is as simple as moving a category – just drag & drop the category tree together with its subcategories and save your changes.

Categories can only be moved into categories that already have subcategories, otherwise it won’t be possible to drag & drop into the category.

Duplicating categories

To duplicate a category, first choose the desired category in the left category tree with a click and click on "Duplicate". In the following popup you can choose the destination category, under which the duplicated category will be placed. You can also choose whether or not you want to copy the item associations as well.

Note, that duplicating categories works recusively, so all subcategories will also be copied.

Deleting categories

To delete a category, just select your desired category from the tree on the left and click "Delete category".

Assigned items will never be deleted, only the category and the category assignment of the assigned items will removed!

Default settings

  • Active (1): Here you can set your category as active or inactive. Please note that disabled categories lose their SEO power! Subcategories are still active, but are no longer displayed in the category tree since you disabled the main category. Additionally, the main items assigned the subcategories will still be available and active!

Items that are assigned to a disabled category can still be searched for in your online shop and/or will still appear in Shopping Worlds. Items must be disabled manually.

  • Blog category: (2) here you can set whether the category is a default item category or a blog category. In blog categories, only blog articles can be displayed. If you set your category as a blog category, you can provide blog articles with the blog module in Content > Blog
  • Description: (3) this is the name of your category. The name can also be changed here.
  • Product Layout: (4) This option inherits the template selection of the Emotion Template lets you choose between the different item layouts (detailed information, only important information, only image, parent setting). With the parent setting, you can build a setup where you only provide a selection for the main categories and all subcategories inherit the layout from their parent.
  • Product Stream: (5) with this setting, you can assign a product stream to your category, since Shopware 5.1.4 this works also when your category has sub-categories. If your category has no assigned stream, it will get assigned items based on the settings of your sub-categories automatically.
  • Link to an external site: (6) with this setting, you can allow your category link to an external site in the frontend. If you do this, the URL has to start with http:// or https://. Note that you can't link the main category (i.e. "English") to an external site.
    Link target: (7) If you want to link to an external page, you can specify here how it should be opened. If you choose _blank a new tab will be opened. _parent opens the external page in the current tab.
  • Image: (8) you also have the option of assigning an image to your category. This image will be provided in the advanced menu of the responsive template.
  • Do not display in top navigation: (9) here you can make your category invisible in the top navigation in the frontend. By default, it will still be displayed in the sidebar navigation. This setting only works for categories on the 1st level.

CMS functions

In the CMS function, you can provide SEO relevant content for your visitors, giving your category a headline and a description. The text should match the categories content, since your visitors and search engines can read this content.

Do NOT simply copy & paste your content from other websites or word documents, otherwise you may paste external formatting and destroy your template by doing this.

Provide meta information

In providing meta information, you optimize your category for search engines. This is because only search engines "see" this information. For this reason, it’s important you provide useful content. If you don't provide meta information, keywords will be left empty and the description and title will be inherited from the CMS description in the category name. Keywords must be separated by a space – in the description, regular text without HTML commands is allowed. If you do not provide meta information for the shop’s main category, Shopware will inherit the meta text snippets from the snippet manager.

Additional free text fields

By opening the area free text fields you can fill up to 6 free text fields. You can use these fields in the frontend, SEO engine, URL structure, etc.

Item mapping

Mapping in the category module

In the item mapping, you can quickly and easily map items to your category.

Using Searching (1), you can search for the order number and item name. To map items, mark items in available items (2) and either click the arrow icon or use drag & drop to move them to mapped items (3).

An item can be mapped to as many categories as necessary. However, take care to map items to appropriate categories since the search also uses category mappings. An item in Shopware can only be mapped in the lowest level category, since main categories inherit all items mappings from their lower level categories. Mapping in main categories is not supported.

The drag-and-drop function for the assigned articles is only used to remove the article assignment and does not affect the sequence of articles. If you move an article to a higher row, the article assignment will be removed.

Mapping in the item module 

In the tab "categories", you can define in which categories your item should appear. Just choose your desired category (1) in the left column and drag & drop it to the hatched zone (2). You can also click the green + Icon In the block mapped categories (3), all active mapped items will be shown. If you mapped more categories per shop, you can define a SEO category of the product, which will be used for generating the SEO URL for the desired shop. Please note that changing SEO URLs may cause problems with your SEO ranking when indexed SEO URLs can no longer be reached. Here you can decide on your own how the SEO URL should be generated for your item. First, choose your Shop (4) and Category (5) that should be used for generating the SEO URL.

Restrict category

Here you can define the customer groups that can see the category in the frontend. This is to ensure that certain customer groups do not see the category in the frontend.

Mark the Available customer groups (1) and drag & drop the desired customer group into the Block category for (2). You can also use the arrow icon to move the customer group. After doing this, save your changes. 

This setting won't concern the mapped items, If you want to restrict these too, you have to do this for each item separately in the article module.

Filter/ Sorting

Custom sortings

You can choose an individual sorting for a specific category.

  • Hide sortings: The sortings will be displayed in the category.
  • Active: Activates the option.
  • Available sortings: Choose one of the default sortings via dropdown (multiple selection possible).
  • Apply to subcategories: The chosen sortings will be applied to the subcategories.

Custom filter

With the individual filters you offer the customer the possibility to filter the products of the category according to special filter properties.
  • Hide filters: The filters will be displayed in the category.
  • Active: Activates the the filters.
  • Available filter: Choose one of the available filters (multiple selection possible). The filter will be applied if minimal one item have the filter property.
  • Apply to subcategories: The chosen filters will be applied to the subcategories.

You still can filter for your individual properties, which can be added in the Item properties. For filtering the option "filterable" must be active.

Custom sorting

Here you can sort the content of each category individually. You can choose a predefined sort or create your own sort.


In the article list (1) you can determine the order of the articles from this category by Drag & Drop. The position can also be assigned by double-clicking in the position box.
Via the display setting (2) you can display the articles as a grid. Here you can also arrange the articles by drag & drop. 
With the Reset button (3) you can reset all set positions. If you only want to remove a certain positioning, you can do so by clicking the X symbol (4) next to the respective article. In the sorting menu (5) you can define a sorting that applies to all articles whose position you have not manually assigned. 
Via the search field (6) in the upper right corner you can search for further articles and add them to this category to be able to position them directly. 

The sorting set up here is displayed in the listing as soon as the sorting Position is selected.
If you want this sorting order to be selected by default, you can set this in the Filter / Sorting tab in the Custom sorting area. Set the area to active and drag the point Position to the top. 

Adjustments for existing sortings

In order for the custom sorting to be displayed in the listing, it is important to add a further order to the desired sorting. To do this, go to the basic settings of the sorting by following the path Settings > Basic settings > Frontend > Filter / Sorting and add the order “Sort by position” for the relevant sorting e.g. Release date (1) under the option Settings (2). Now a window opens in which you can choose whether the lowest or the highest positions should be displayed first. You have added the order to an already existing sorting, so that the remaining products, which have "dynamic" as position, are sorted by the respective sorting.

  • Name: The name will be displayed in the frontend sorting selection.
  • Active: If deactivated, this sorting won’t be displayed in the frontend or used as default sorting. Custom assignments will remain but won’t be used.
  • Display in all categories: If active, the sorting can be used by default in categories, which don’t have a custom sorting configured. For these categories, you have to assign the sorting manually
  • Settings: Keep in mind: Sort by search relevance is only applied in search results

Create an individual sort order

To use the individual sorting in a category follow these steps:

  1. Go to Settings > Basic settings > Frontend> Filter / Sorting > Sortings and call up the sorting position . Set a tick in the Active checkbox and, if desired, also in the Display in all categories checkbox if the sorting should be available in all categories.
  2. Now go to Article > Categories and select the category for which you would like to define an custom sorting. Change to the tab Filter / Sorting. Set the active hook in the area Custom sorting.
  3. Under Available sortings, move the Position item to the first position so that the green tick is visible in the column Default.
  4. Then switch to the Custom sorting tab. There select position in the field Sorting. Now you can define the positions of the articles individually. Either by moving them or via the column Position.

Tips & Tricks

Sorting in the category listing

You can set the default sorting here:

Configuration > Basic settings > Frontend > Categories / lists > Default category sorting:

By default, Release date is set.

Was this article helpful?