Sources
A source is what the shop can filter by: a product field, a property group, a variant option, a custom field or a value P2Lab Filter works out, such as “in stock”. Each group of a filter set reads one source. The sources are listed under Catalogues → Filters → Sources → Sources.
The list builds itself from the shop’s data. Detect again reads the shop once more, for example after new property groups or custom fields were added. A source’s settings (label, URL name, display, ranges) are inherited by every set and work as soon as they are saved, without publishing.
Kinds of source
Section titled “Kinds of source”The Kind column sorts the sources into families:
| Kind | Sources |
|---|---|
| Product field | Manufacturer, Tags, Price, Rating, Free shipping, Dimension (weight, width, height, length) |
| Property | Each property group of the shop |
| Variant option | Each property group that builds variants (a product’s sizes, colours) |
| Custom field | Each product custom field a filter can read |
| Computed | Availability (stock above 0), On sale (price below the list price), New, Category (subcategories of the current category), Search in results (words in the name, number or brand) |
| Compatibility | Each compatibility catalogue |
- New takes the products released within the sales channel’s “mark as new” days of Shopware’s listing settings.
- A custom field becomes a source by its type: a single selection is a list of values, a number a range, a yes/no field, switch or checkbox a switch, a date a span from – to. A text field and a multiple selection are not sources.
- A property group that is not Filterable in Shopware shows in the shop only where a set lists it, never as an automatic group.
The list’s other columns are URL name, Default display, Used in sets, Values and State. The sidebar filters by name (also field and URL name), kind and state.
| State | Meaning |
|---|---|
| Ready | Nothing to do. |
| Needs the search index | OpenSearch cannot filter by this custom field until the index is built again; the Values check says how. |
| No URL name | Some values have no URL name: landing pages and readable addresses do not use them. |
| Not filterable in Shopware | Turn on Filterable in the property group, or the shop shows it only where a set lists it. |
| Possible duplicate | Two values differ only in case or accents: merge them in the Values check or on the Values tab. |
A source’s settings
Section titled “A source’s settings”A click on a source opens it. The column on the left holds its settings in tabs; the right side shows what they lead to. Every source has General; a source with a list of values adds Values and Groups; a range adds Ranges and Units. A property group shown as a slider counts as a range.
Each setting shows where its value comes from: the Shop defaults for the source’s kind or for all groups, or the built-in value. A value set on the source overrides them and is inherited by every set’s group of the source, unless the set’s group sets its own. The Used in sets table lists each set using the source, the group’s label there, its display and what the set overrides.
The language switch at the top edits the translated fields in another language.
General
Section titled “General”| Setting | Effect |
|---|---|
| Label | The source’s name in the shop. Empty uses Shopware’s name: the property group’s, the custom field’s or the field’s. |
| URL name | The filter’s name in readable addresses; see URL names. |
| Hint | A short note for shoppers, for example “the shade depends on the screen”. |
| Display | The default display of the source’s groups. |
| Between values | Any (OR) or All (AND) by default. |
| May go to landing pages | Whether a landing page’s filters may use this source. By default lists of values and the price may, switches, stars and other ranges may not. Its values become links in the panel only where they lead to a landing page. |
From Shopware shows, read-only, what Shopware decides about the source (the property group’s display type, sorting, Filterable; the custom field’s type and set; the price’s currency) with a link to change it there.
Address in the shop shows one real value of the filter as the address of the channel’s first category, in the channel’s format from SEO → Filter URLs. Former names lists the names the filter and its values had before; an address that still uses one leads to today’s. Translations shows the label and URL name in every language.
Values
Section titled “Values”The Values tab lists every value of the source, a page at a time however many there are. The settings in the column are Value order, Selected first and Without products, the defaults of every set’s groups of the source.
| Column | Effect |
|---|---|
| Colour, Image | The value’s swatch or image. |
| Shown as | An alias: the name the shop shows instead of the value’s own. |
| Name in the URL | The value’s URL name in this language. Without one the shop uses the default language’s. |
| Group | The value group it belongs to. |
| Pinned | Pinned values come first in every set. |
| Hidden | Hidden values never show in any set. |
| Products | How many products of the whole catalogue have the value. |
A double click on a row edits it. The row menu holds:
- Images…: an image of your own per language, used by the Logos and Swatches displays. A language without one shows the default language’s, and without that the image Shopware has.
- Merge into…: the shop shows the target in place of the merged values; the products of all of them count for it, and their addresses lead to it. Unmerge takes it back.
- Into a group…: puts the value into a value group picked by hand.
Several values can be ticked and changed at once: Hide, Show, Pin, Unpin, Merge into…, Into a group…, URL names…. Select all N results changes every value the search and the filters find; such a change runs in the background under System → Tasks.
Groups
Section titled “Groups”A value group stands in the shop for several values at once: “Down” for goose and duck down, “Blues” for navy and blue. It shows wherever a set lists the source with Any (OR) between its values. The Groups tab shows the groups as cards in the shop’s order; Add value group adds one.
| Setting | Effect |
|---|---|
| Name | Shown in the row, the chips and the summary. |
| URL name | For the group’s short address; empty: made from the name. |
| In the shop | Expandable: in a list the group’s row has a disclosure and a three-state box, its values under it. One item: the group is one item in every look, and picking it picks any of its values. In pills, radios, tiles and swatches a group is always one item. |
| Colour of the group | The group’s swatch among swatches; a dot in a list. |
| Whole group in the address | When the shopper picks the whole group: As SEO says, Its values (each value named) or Its name (the group named once by its URL name). Part of a group is always written as its values. |
| Place in the order | 1 is the first in the shop. A value that two groups take belongs to the earlier one. |
| Values of the group | Picked by hand, or a rule: a name pattern or a range of the number a name starts with. With a rule, new values join by themselves. |
| Icon | Before the name in a row and a tile, in the skin’s colour. |
A value without a group shows in the shop on its own, after the groups. Deleting a group leaves its values as they are.
Ranges
Section titled “Ranges”The Ranges tab holds ready ranges for the Ranges control (for example “Up to 50”, “50–100”, “100 and more”).
| Setting | Effect |
|---|---|
| Range control | The default control of the source’s groups. |
| Number of ranges | 3, 4 or 5: how many ranges the automatic list and Generate nice ranges aim at. |
Without ranges of its own the shop cuts about that many round ranges from the values on each page. Generate nice ranges writes them into the list, where they can be named and changed; Add range adds one. Each range has a Label in the shop, From and To; an open end has no bound. The list warns of gaps (products in no range) and overlaps (products counted twice). In the shop the counts are live for the current page.
The Units tab sets how the source’s numbers read in the shop, in every set.
| Setting | Effect |
|---|---|
| Unit | The unit after the number. The price’s is the sales channel’s currency. |
| Thousands separator | From 10 000, Always or Never. |
| Decimal places | As stored, 0 or 2. |
| Short forms on the scale | From 10 000 the slider’s scale writes “15K” instead of “15 000”. |
| Switch the unit | Dimensions only: a weight under 1 kg in g, a length from 1000 mm in m. |
What the customer sees shows the group’s head and chip, a range, and the smallest and largest value as the edited language writes them. Slider scale shows the scale over the whole catalogue; in the shop the slider spans each page’s values.
URL names
Section titled “URL names”A source’s URL name is the filter’s name in the shop’s addresses, for example ?colour=red with readable addresses. Values and value groups have URL names too.
- A URL name holds lower-case letters and digits joined by hyphens, up to 64 characters.
- It names one thing in its language: a source’s among the sources, a value’s or a value group’s among those of its source. A name already taken is refused.
- A source cannot take a name the shop’s addresses use themselves:
p,order,limit,search,properties,manufacturer,categories,tag,find,fit,rating,shipping-free,in-stock,on-sale,is-new, and names starting withmin-,max-,cf-orp2f-. - Left empty, the shop makes the name from the label. A name typed in stays yours.
- A changed name keeps the old one as a former name, so old addresses still lead to the filter or value.
Generate URL names… on the Values tab makes names for many values in the background:
- Values: every value of this source, of every source with values, the values picked in the list, or those the search and filters find; and the languages.
- Template: a Twig template, as SEO URLs in the shop’s settings, with the variables of the value’s alias or name, its name, its alias, and the source’s name and URL name. Save as default for this kind keeps it for the sources of this kind.
- What to name: Only the missing ones, Missing and made by a template, or All, written by hand too. When a name is taken in the source: Add -2, -3 … or Leave the value as it is.
- Check and run: the summary, then Run. The task’s result lists the names that were taken.
Every URL name the shop writes is listed under SEO → URL names; see filter URLs.
Values check
Section titled “Values check”Filters → Sources → Values check lists what keeps the sources from working or reading well, worst first, in the content language: values without a URL name, URL names shared by values or by sources, values alike but for case or accents, colours without a swatch, slider values without a number, property groups not filterable in Shopware, custom fields the OpenSearch index cannot filter by, and value groups taking no value or sharing one.
The tabs Issues and Without issues split the sources. A row offers its fix where there is one: Generate URL names now, Merge, Fix in Shopware ↗, Open source. The check runs in the background, a few sources at a time; Check again repeats it.