Every setting of the bundle plugin

The Product Bundles plugin for Shopware 6 comes with 18 settings, grouped into 6 sections. This page describes each one with its purpose, its default value and the options available.

You find the settings in the administration under Extensions → My extensions → Product Bundles → Configuration. Every setting applies per sales channel.

All settings at a glance

Setting	Section	Type	Default value
Activate plugin	Default	Switch	on
Show reference to bundles	Product detail page	Switch	on
Deactivate the display of the number of pieces for "1 piece	Product detail page	Switch	on
Combine multiple father products	Product detail page	Switch	off
Behaviour when products are not available	Product detail page	Choice	Remove bundle
Show product image	Product detail page	Choice	Cover
Sort variants	Product detail page	Choice	By name
Position of the details in the display below the shopping cart button	Product detail page	Choice	Above the bundle buttons
Show badge	Listing	Switch	on
Productnumber of the bundle	Checkout	Text field	{{ product.productNumber }}-bundle
Productnumber of the bundle rebate	Checkout	Text field	{{ product.productNumber }}-bundle-discount
Show product image for the bundle	Checkout	Choice	Show image of the father product
Add product custom fields to configurator components	Checkout	Switch	on
Exclude bundles from discounts and promotions	Checkout	Switch	off
Dissolve the father-child relationship	Orders	Switch	on
Remove father product	Orders	Switch	on
Save discount as voucher	Orders	Switch	off
Automatically remove duplicate father product	Generic bundles	Switch	on

Default

What does the setting "Activate plugin" do?

Switches the plugin on or off for the selected sales channel. While it is off, no bundle appears there.

Section: Default
Type: Switch
Default value: on
Technical name: status

Help text in the administration:

Enables the plugin for the current sales channel.

Product detail page

What does the setting "Show reference to bundles" do?

Shows a note directly below the add-to-cart button when one or more bundles exist for the product.

Section: Product detail page
Type: Switch
Default value: on
Technical name: pdpShowBundleNotice

Help text in the administration:

Displays a note directly below the shopping cart button if one or more bundles are offered for a product.

What does the setting "Deactivate the display of the number of pieces for "1 piece" do?

Hides the quantity badge on every component that sits in the bundle with a quantity of one.

Section: Product detail page
Type: Switch
Default value: on
Technical name: productDetailHideSingleQuantityInfo

Help text in the administration:

Deactivates the display of the number of pieces for all components of a bundle that are defined with "1 piece". Should be deactivated - for a uniform look - if you mainly offer bundles with a larger number of pieces of the individual components.

What does the setting "Combine multiple father products" do?

Merges the quantities when the parent product is also a component of the bundle: instead of one Product A plus nine Product A it reads ten Product A.

Section: Product detail page
Type: Switch
Default value: off
Technical name: productDetailMergeMultipleFatherProducts

Help text in the administration:

If the father product is also included in the bundle, should the quantity of all father products be combined? Example: 10x product A - instead of 1x product A + 9x product A. This option is only valid for complete bundles and is ignored for selectable bundles.

What does the setting "Behaviour when products are not available" do?

Decides what happens to a bundle that contains an inactive or sold-out product.

Section: Product detail page
Type: Choice
Default value: Remove bundle
Technical name: soldOutProductsBehaviour

The options are:

Remove bundle – The bundle is removed and no longer available for purchase.
Remove product from bundle – The unavailable product is removed from the bundle and the bundle is sold with the remaining products.
Oversell product – The bundle remains fully available and the product is oversold. If the product is unavailable (e.g. offline), the product will be removed from the bundle.

Help text in the administration:

How should bundles behave if they contain an invalid (e.g. offline) or sold-out product (sale without stock)?

What does the setting "Show product image" do?

Decides which image of a component appears in the bundle overview. If the chosen image is missing, the cover is shown.

Section: Product detail page
Type: Choice
Default value: Cover
Technical name: pdpMedia

The options are:

Cover
First media
Second media
Third media

Help text in the administration:

Which product image of the individual products should be displayed in the bundle overview? The cover is also displayed if the desired image is not available.

What does the setting "Sort variants" do?

Decides the order of the variants in the select field when a component sits in the bundle as a variant parent.

Section: Product detail page
Type: Choice
Default value: By name
Technical name: pdpSortVariants

The options are:

By name
By display order of the storefront display

Help text in the administration:

How should the individual variants be sorted within the dropdown element for selecting a specific variant if a parent product has been selected in the bundle?

What does the setting "Position of the details in the display below the shopping cart button" do?

Decides whether the detail list sits above or below the buttons when the bundle appears below the add-to-cart button.

Section: Product detail page
Type: Choice
Default value: Above the bundle buttons
Technical name: pdpDetailsVisibilityBelowCartButton

The options are:

Above the bundle buttons
Below the bundle buttons

Help text in the administration:

Where should the details (the individual products) be displayed in the bundle when the bundle is visible below the shopping cart button?

Listing

What does the setting "Show badge" do?

Shows a badge in lists and categories on every product that has bundles.

Section: Listing
Type: Switch
Default value: on
Technical name: listingBadgeStatus

Help text in the administration:

Should a badge be displayed within the listing for all products where bundles are provided?

Checkout

What does the setting "Productnumber of the bundle" do?

Sets the product number of the bundle line. Every field of the parent product is available in the template.

Section: Checkout
Type: Text field
Default value: {{ product.productNumber }}-bundle
Technical name: checkoutBundleProductNumber

Help text in the administration:

Here you can define the automatically generated product number of the bundle (the bundle container). You can access all variables of the product.

What does the setting "Productnumber of the bundle rebate" do?

Sets the product number of the discount line. Every field of the parent product is available in the template.

Section: Checkout
Type: Text field
Default value: {{ product.productNumber }}-bundle-discount
Technical name: checkoutBundleDiscountProductNumber

Help text in the administration:

Here you can define the automatically generated product number of the bundle discount (the discount as part of the bundle). You can access all variables of the parent product.

What does the setting "Show product image for the bundle" do?

Decides which image the bundle line carries in the cart and in the checkout.

Section: Checkout
Type: Choice
Default value: Show image of the father product
Technical name: checkoutProductImage

The options are:

Do not show image
Show image of the father product
Show individual image

Help text in the administration:

Should an image be displayed for the father (the bundle container) in the checkout? If you select "individual image", please upload or select an image of your choice.

What does the setting "Add product custom fields to configurator components" do?

Copies the custom fields of the products involved onto the bundle line and its components in the cart.

Section: Checkout
Type: Switch
Default value: on
Technical name: cartAddProductCustomFields

Help text in the administration:

Should the components of a configuration receive the standard additional fields (custom fields) of the associated products? This can possibly have influence on other plugins.

What does the setting "Exclude bundles from discounts and promotions" do?

Excludes bundles and all their components from discounts, promotions and vouchers.

Section: Checkout
Type: Switch
Default value: off
Technical name: checkoutDisablePromotions

Help text in the administration:

Should bundles including all components be excluded from all discounts, promotions and vouchers?

Orders

What does the setting "Dissolve the father-child relationship" do?

Dissolves the parent-child relationship when the order is placed: the components then sit next to each other, and the bundle line carries 0.00 and serves only as a marker.

Section: Orders
Type: Switch
Default value: on
Technical name: orderFlattenBundle

Help text in the administration:

By default, all products of a bundle are the children of the bundle father. The father also bears the price of the sum of all products. If you activate this option, the father-child relationship is dissolved for all products and the father receives a price of 0.00 EUR and only serves as information that a bundle was purchased.

What does the setting "Remove father product" do?

Removes the bundle line after the order, leaving only the components and the discount line.

Section: Orders
Type: Switch
Default value: on
Technical name: dropParentContainer

Help text in the administration:

If the option "Dissolve father-child relationship" is activated, you can remove the father product, which in principle is only a container for all components including the discount, after ordering. This means that only all the components of the bundle and the discount item remain.

What does the setting "Save discount as voucher" do?

Stores the bundle discount as a standard Shopware voucher by adjusting the type and payload of the discount line.

Section: Orders
Type: Switch
Default value: off
Technical name: orderTransformRebateToPromotion

Help text in the administration:

Should the discount of the bundle be saved as a Shopware standard voucher? The type and payload of the discount are adapted to correspond to the standard of a Shopware voucher. This can help with possible problems when importing into external third-party systems (ERP).

Generic bundles

What does the setting "Automatically remove duplicate father product" do?

Removes the parent product automatically from a general bundle when it is already a component there.

Section: Generic bundles
Type: Switch
Default value: on
Technical name: specificRemoveDoubleParent

Help text in the administration:

If you define general bundles that are to be assigned to all products of the bundle, then the parent product would be present twice on each product detail page (1x as parent + 1x as part of the bundle)? With this option, you can remove the duplicate parent product dynamically and automatically.

Everything on this page is generated straight from the plugin configuration. When a setting changes in the plugin, this page changes with it.

← Back to the manual