Skip to content

feat: Allow Configuration of Custom Fields to be Searchable #2032

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
tamvt wants to merge 2 commits into
base: main
Choose a base branch
from
Open

feat: Allow Configuration of Custom Fields to be Searchable #2032

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
77a60ce
feat: Allow Configuration of Custom Fields to be Searchable
tamvt Dec 10, 2025
1c8ea07
chore/add-word
Isengo1989 Dec 16, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions .wordlist.txt
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -1749,6 +1749,7 @@ scss
sdk
searchMedia
searchViaAdminApi
searchability
secretKey
selectable
selectbox
Expand Down
9 changes: 9 additions & 0 deletions guides/plugins/plugins/framework/custom-field/add-custom-field.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -257,6 +257,7 @@ $this->customFieldSetRepository->create([
[
'name' => 'swag_example_size',
'type' => CustomFieldTypes::INT,
'searchable' => true,
'config' => [
'label' => [
'en-GB' => 'English custom field label',
Expand All @@ -277,6 +278,14 @@ The translated labels are added to both the field and the set, which are going t

If you have several custom fields and want to order them within a specific order, you can do so with the `customFieldPosition` property.

::: info
Available starting with Shopware 6.7.6.0.
:::

By default, custom fields are **not searchable**. To make a custom field searchable, you need to set the `searchable` property to `true` when creating the custom field. Only custom fields explicitly marked as searchable are available in search configurations. This helps optimize index storage size and improve search performance, especially for stores with many custom fields.

If you enable searchability for an existing product custom field, you must rebuild the search index or update the products manually to include the custom field data in search results.

::: info
If you want the custom field set to be deletable and editable in the administration, you need to set global to false
:::
Expand Down