Shopware offers you several settings for the listing. Here you get an overview of the most important functions, such as the categories / lists, individual filters & sorting and variants in the listing.

Categories / lists

These settings determine how product lists will appear in the frontend. You can find this window by following Configuration > Basic settings > Frontend > Categories / lists.

  • Items per page: this defines how many items are displayed by default within the product listing.
  • Selection of items per page: this gives the customer the possibility of selecting how many products should be displayed in the listing. The value entered here should be divisible by the “Items per page”.
  • Available listing layouts: here you can define your own developed listing layouts. If you don't need this, you can select the listing layout in the categories itself.
  • Jump to detail if only one item is available: if this setting is active, Shopware jumps directly to the product detail page when the category contains only 1 product.
  • Move categories into batch mode: reclassification of categories are performed separately in batch mode. This is recommended for especially extensive category structures.
  • Always display the defined product preview image in list views: only the main preview image will appear in the listing, regardless of the image mapping.
  • Default category sorting: Define the default sort order used for all categories here. If you want a different default sorting for individual categories, you can change this in the category settings.
  • Consider product minimum order quantity for cheapest price calculation: when active, Shopware will display the price of the minimum order quantity, otherwise the base price of one piece will be displayed.
  • Consider product graduation for cheapest price calculation: when active, Shopware will display the cheapest price for the largest graduation. When inactive, Shopware will display the cheapest price for 1 piece. Please Note, that this option is not compatible with pricegroups. If you use them, this option will be ignored. Caution: This option always shows cheapest price for the largest graduation in the listing, even if this graduation cannot be reached for an on sale product.
  • Maximum number of items per page: defines the maximum number of items per page. This prevents calling lager item amounts per url parameter.
  • Display buy button in listing: If active, all not restricted products will get a "Add to cart"-button, if the product is restricted, it gets a "Details"-Button, which guides the user to the products detail page. Restricted products are those, who have variants, graduated prices or which have prices which are manipulated by plugins like LiveShopping, Promotion or Bundle). This forwarding to the detail page is justified by law, because the customer must see the exact product price before he adds it to the cart.
  • Manufacturer page product layout: Specify here which layout is to be used for the product listing on a manufacturer page.

Individual Filters & Sorting

You can create new filters and sortings to improve the user experience of your shop. 

These following settings are compatible with any subshop. The handling however slightly differs from other subshop settings: In the basic settings you can set up all your favourite filters & sortings. Via the shop's categories you can define, which will actually be presented to your users.


The filters can be set up in the basic settings in "Frontend > Filter / sorting" in the "Filter" tab.

Basic handling

In the overview you can see all available filters. You can also see, which filters are active and whether filters are displayed in all categories by default. By clicking on a filter you can edit its preferences using the form on the right hand side and save it afterwards.

The option "Display in all categories" makes that particular filter appear in every single category by default. This way you will have to disable it later for every category you want to exclude. If you only want to apply your filter to specific categories, we recommend to leave this option unchecked.

By default, Shopware holds the following filters:

  • Categories - Caution: This filter was developed for search purposes only. The UI does not restrict this option in any way. It is therefore possible to set this filter for categories, however this won't work at all.
  • Immediately available
  • Manufacturer
  • Price
  • Properties
  • Shipping free
  • Rating
  • Weight (inactive by default)
  • Width (inactive by default)
  • Height (inactive by default)
  • Length (inactive by default)

Add attribute filters

By adding an attribute filter, you can sort your items in the listing by a specific attribute field. In that case it doesn't matter in what way the attribute is configured.

Click the button "Add attribute filter", to create a new filter. On the right hand side, an empty form appears. Here you can adjust your settings:

Here you can make use of the following parameters:

  • Name: Name your filter for internal usage.
  • Active: Activate or inactivate the filter.
  • Display in all categories: Activate this checkbox if you want the filter to be active in all categories by default.
  • Select free text field: Choose a free text field, which acts as a data source for your filter.
  • Display mode: Set the display mode here. Possible options are: single value selection, multi value selection, checkbox and range slider.
  • URL parameter: Set a URL parameter that is used for the filter. The parameter will be added to the URL like all the other filters too. So you can also call for filtered listings directly via URL.
  • Label: Set the Label for your filter here. The label will be used in the frontend.
  • Template file: If your filter is expected to behave like the template default, just keep this field blank. If you want to customise this filter, set the template file path here. The template path has to match the Shopware defaults. The frontend template path looks like this: frontend/listing/filter/my-filter.tpl.

Add combined filters

Combined filters use product streams or a list of items as their data source. They are prefiltered by a set of predefined filter conditions. Using the combined filter, you can simply use a self-determined set of items as a filter condition in the listing.

Here you can make use of the following configurations:

  • Name: Name your filter for internal usage.
  • Active: Activate or inactivate the filter.
  • Display in all categories: Activate this checkbox if you want the filter to be active in all categories by default.
  • Label: Set the Label for your filter here. The label will be used in the frontend.
  • URL parameter: Set the URL parameter which is used for the filter. This will be added to the URL like all the other filters too, so that you can also call filtered listings directly via URL.
  • Use Product Stream: Here you can choose pre-saved product streams as a filter condition. If the user clicks the filter in the frontend, all items belonging to the product stream will be shown.
  • Add condition: If you don't want to use pre-saved product streams, you can define new filter conditions here. Clicking the filter in the frontend will filter all items by the here set conditions.


With individual sortings you are able to offer a better customer experience by providing better sortings in the item listing.

The sortings are configured in the same module the filters are configured in. Just navigate to "Basic settings > Frontend > Filter / Sorting" and select the Sortings tab.


In this module you can see all existing sortings. Clicking an entry will refresh the form on the right hand side. Here you can edit and save the sorting.

By default, Shopware holds the following sortings:

  • Release date: Sorting by release date (new release first/last).
  • Popularity: Results from sales + impressions, so it is important for the correct function that the topseller index is regularly rebuilt. Can be increased/influenced by pseudo sales in articles. (Most popular first/last)
  • Lowest/highest price: Sort by price 
  • Item name: Alphabetical sorting by item name (A-Z, Z-A).
  • Position: Sorting by position. Depends on the manually set individual sorting in the respective category (Lowest/Highest position).
  • Item number: Alphabetical sorting by item number (A-Z, Z-A).
  • Best results: Sorting by search relevance when entering search terms. More relevant results are displayed higher up in a search.

Add a new sorting

To add a new sorting, click the button "Add item". The form on the right hand side will reload to a blank one, where you can set your desired options:

  • Name: This is the name of this sorting, but note that this name is also used in the frontend!
  • Active: Set the sorting as globally active or inactive.
  • Display in all categories: Checking this, the sorting will be active by default for all categories. This is useful, if you want to use this sorting in the majority of your categories. If you only want to use this sorting in a few instances , leave this empty.
  • Settings: Here you can set the sorting's criteria: Sorting by name, popularity, price, product, free text field, release date and search relevance is possible.

Category settings

The above described filter and sortings are set globally for your whole Shopware instance. To individualise these settings, go to the the categories' settings.


The settings tab is separated into two areas: filter and sortings. In each area you can set an individual sorting and a number of options to customise this category. This can be useful if you want to show or hide specific filters / sortings.

When manually activating one of the two, the options below will activate automatically, so you can choose your custom settings in this category. On deactivation, the options will be reset to default. This is a convenient way of rolling back the shop's default values.

By adjusting your settings, you can get rid of any options you don't want to use and set a desired sorting as default in the frontend. Note that the options will be restored when deactivating the option again.

By activating the checkboxes "Hide sortings" and "Hide filters" you can make the whole function disappear from the frontend. With the button "Apply to subcategories" you can apply the settings to all subcategories and accelerate your rollout.

Using the drag-and-drop symbol at the left of the options list you can easily arrange the options in an order you prefer.

Variants in the listing

Here is described how you can configure the appearance of your variants in the listing. Using this feature, your customers are able to see the right variant in the listing directly. This way they don't need to open the main article anymore.

In this context we distinguish the simple filter from the "Expand"-feature. Filtering' means that Shopware shows you the product variants depending on your selection of the configurator options (not like before using item properties). Expanding describes that the product variants, which match your selected filters, are displayed separately in the listing as an own variant.

However, please keep in mind: If your product is multidimensional (e.g. clothes: colour and size) and you filter by the colour blue, Shopware will show you a variant box with the info "Colour: blue". However, because of the fact that the colour blue has multiple sizes, this is no a specific variant. It will be displayed as a selection of all variants with the colour blue. A specific variant is shown only in the case when the user filters by all configurator options the product possesses, e.g. colour: blue and size: L.

If you currently use properties to filter your listing, you may get duplicate filter by activating expanded variants, because colour e.g. is a property and an active expanded variant filter. To avoid this duplicates, you should search your listings for this duplicates. We recommend to use the expanded variants and deactivate the properties to get a cleaner filter panel for your customer and to let your customer see the variant after filtering instead of the whole product.

Expanding variants will cost performance because the listing has to handle much more datasets. For that reason, we advise not to expand all variant groups. Because filtering them may result in thousands of variants to load in the listing that causes the listing to be slower and generates a much lower user experience! So only expand variant groups when appropriate!

Difference between properties and "Variants in the listing"

Up to Shopware 5.3 you were only able to filter by items properties. Those are a kind of describing tool for your customer to let him know, what the items properties are like. Since properties are attached to the whole product and not its variant, Shopware always shows the whole product after filtering. The variant selection must be done by the customer after clicking the result. Filtering by variants using this new feature will show the customer the filtered variant or variant group with its data, so the customer gets the related variant (-group) after filtering and may only refine his selection if needed.


You can find the settings for this option in Configuration > Basic settings > Frontend > Filter/Sorting:

In the tab "Filter" you can find the entry "Variants". Just activate it and choose the desired variant groups you want to filter in the listing:

After you choose your desired group, you can set the expand-option for each selection to enable the expand-option. Just click the red X to switch it to the green hook icon.


In the frontend you can execute the filter, doing that the products will be expanded depending on your settings:

The matching option is highlighted at the product box and the variant is preselected by Shopware, so the listing will directly show you the right variant with its image, as long you set an image mapping for it.

Was this article helpful?