Custom Fields

Custom fields are a core feature of Shopware 6 and let you extend products, categories or manufacturers individually. With custom fields you flexibly store additional information and output it in the storefront when needed.

The following step-by-step guide shows how to create a custom field, using a GPSR "safety notice" as an example.

---

Creating a custom field set

Important: Create a separate custom field set for your individual custom fields and do not use the ThemeWare® sets or existing sets from other themes and extensions.

Note: You don’t need to create a separate set for every single additional field, but as the number of additional fields increases, sets help you to keep track of them all.

1) Create a new custom field set

Go to the custom field management:

"Settings" => "System" => "Custom fields" => "Create set"

Click "Create set" and create a new custom field set.

• Technical name: e.g. custom_gpsr

• Label: e.g. GPSR (products)

• Use for: Products

---

Creating a custom field

Important: Create a separate custom field set for your individual custom fields and do not use the ThemeWare® sets or existing sets from other themes and extensions.

1) Create a new custom field

Click "New custom field" and create a new custom field.

• Type: e.g. Text editor

• Technical name: e.g. custom_gpsr_safety_notice

• Label: e.g. Safety notice

2) Fill in the custom field

Go to the product management and edit the desired product. Fill in the new custom field (e.g. "Safety notice"):

"Catalogues" => "Products" => "Specifications" tab => "Custom fields" section => "GPSR (products)" tab => "Safety notice" field

Tip: Since we created a custom field of type "Text editor", you can also apply HTML formatting.

---

Outputting a custom field in the storefront

Since neither Shopware nor ThemeWare® can know where your individual custom field should appear, you embed it manually – either via a CMS element in a Shopping Experiences layout (simple, from Shopware 6.6.9) or via an individual template customization (more flexible, incl. empty check):

Show custom fields in the storefrontShow custom fields in Shopping Experiences

---

Ready-made ThemeWare® features using custom fields

Many ThemeWare® features already use prepared custom fields – so you don't create anything yourself, you just fill in the fields and enable the feature in the theme configuration. The matching step-by-step guides:

Product pages

• Embedding product videos (YouTube & Vimeo)

• Providing datasheets as PDF

• Providing downloads on products

• Showing care symbols & product symbols

• Showing GPSR information on product pages

• Creating a custom tab on the product page

Categories & navigation

• Setting up a hover image in the listing

• Setting up a category hero section

• Showing subcategories in the listing

• Setting up the Mega Menu

• Highlighting a category in the navigation

---

Further information

You can find more information about ThemeWare® custom fields in the ThemeWare® manual:

Custom fields | ThemeWare® Manualdocs.themeware.design

ThemeWare® Manual ⇒ Custom fields