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
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?

Enables the plugin for the current sales channel.

Section
Default
Type
Switch
Default
on
Technical name
status

Product detail page

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

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

Section
Product detail page
Type
Switch
Default
on
Technical name
pdpShowBundleNotice

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

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.

Section
Product detail page
Type
Switch
Default
on
Technical name
productDetailHideSingleQuantityInfo

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

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.

Section
Product detail page
Type
Switch
Default
off
Technical name
productDetailMergeMultipleFatherProducts

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

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

Section
Product detail page
Type
Choice
Default
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.

What does the setting "Show product image" do?

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.

Section
Product detail page
Type
Choice
Default
Cover
Technical name
pdpMedia

The options are:

  • Cover
  • First media
  • Second media
  • Third media

What does the setting "Sort variants" do?

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?

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

The options are:

  • By name
  • By display order of the storefront display

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

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

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

The options are:

  • Above the bundle buttons
  • Below the bundle buttons

Listing

What does the setting "Show badge" do?

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

Section
Listing
Type
Switch
Default
on
Technical name
listingBadgeStatus

Checkout

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

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

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

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

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.

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

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

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.

Section
Checkout
Type
Choice
Default
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

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

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.

Section
Checkout
Type
Switch
Default
on
Technical name
cartAddProductCustomFields

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

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

Section
Checkout
Type
Switch
Default
off
Technical name
checkoutDisablePromotions

Orders

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

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.

Section
Orders
Type
Switch
Default
on
Technical name
orderFlattenBundle

What does the setting "Remove father product" do?

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.

Section
Orders
Type
Switch
Default
on
Technical name
dropParentContainer

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

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).

Section
Orders
Type
Switch
Default
off
Technical name
orderTransformRebateToPromotion

Generic bundles

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

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.

Section
Generic bundles
Type
Switch
Default
on
Technical name
specificRemoveDoubleParent

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