Cart Add-ons - paid extra options

Installation

1. Get the plugin from the Shopware account via the marketplace, or upload the ZIP manually through „Extensions → My extensions“.
2. Under „Extensions → My extensions“, install and then activate the plugin.
3. Cache clearing is automatic. If the storefront does not show the add-ons immediately, flush the cache manually via „Settings → System → Caches“.

Where to find the plugin in the admin

After activation, the new entry „Priority options“ appears in the left sidebar under Settings. All add-ons are managed there.

Creating a priority option

1. Click „Create priority option“ in the top right.
2. Card „General“: set name, description, active, tax class, visibility rule and position (sort order in the toggle list). Multilingual via the language switcher in the top left.
3. In „Display“ pick the display mode (see below). Depending on the mode additional cards appear.
4. Card „Price“: enter the customer price (gross/net). Per option a tiered price block via the Shopware rule system is also available.
5. Card „Image (toggle cover)“: optional small thumbnail (~64×64 px) for the selection list in the cart. Not used in inline mode – there the badge icon takes over.
6. Card „Availability per context“: six toggles for the storefront contexts (see „Visibility“ below).
7. Save – the option is available in the cart immediately.

Display modes (card „General“ → field „Display“)

One of four modes per option – this determines how the customer sees and selects the option in the cart.

• Line Item (Default): a classic cart line, just like a product. Appears in the order as a regular position. Good for add-ons with their own „delivery scope“ like gift wrapping.
• Badge: a standalone banner in the cart summary, freely positioned and styled. The price folds into the grand total, not a separate cart line. Ideal for prominent marketing add-ons (priority handling, express).
• Summary Row (like Shipping): a plain dt/dd row in the summary next to shipping and grand total. Visually unobtrusive. Good for small surcharges like tipping or green donations.
• Inline (in toggle): a dedicated card with icon tile, subtitle and a large toggle right in the selection list – the active option stays visible there (no extra badge). In the order context (finish/account) it automatically falls back to the summary-row mode.

Position in the cart (card „Display“ → field „Position in summary“)

For each add-on you can choose where it appears in the cart layout. Eight slots are available:

• Above shipping
• Below shipping
• Right before grand total
• Above checkout button
• Below checkout button
• Above voucher field
• Below voucher field
• Between line items and subtotal

The slots apply to Badge and Inline modes. For Summary Row only the first three take effect (all others are ignored because they sit outside the summary list) – the admin shows a corresponding hint. The Line Item mode always appears in the cart line-item table.

Visibility (card „Availability per context“)

Per add-on you can decide in which storefront contexts the option is offered:

• Available in Cart
• Available in Offcanvas Cart
• Available during Checkout Login/Register
• Available on Checkout Confirm
• Available on Checkout Finish
• Available in Account Order History

Important: once a customer has activated an option, it stays in the cart even if the option is no longer offered in a subsequent context. The visibility control only hides the selection, not the already-selected line. This prevents accidental cancellation by mere navigation. To hide an option entirely, set it to inactive in the „General“ card.

Badge settings (only visible when mode = „Badge“)

The „Badge Settings“ card appears only when the mode is set to Badge:

• Badge style: Pill Filled (default), Pill Outlined, Rect Outlined or Feature Card (with icon tile + subtitle).
• Background color + text color – free hex values via color picker.
• Close-X behavior on the badge – six options for how the „X“ button on the active badge appears and behaves:
  • Hover-Blur (desktop) + Inline-X (mobile, default) – recommended default
  • Inline-X right (always visible)
  • Slide-Reveal (X slides in from right)
  • Top-Right-Overlay (small circle outside)
  • 2-Click-Confirmation („Remove?“)
  • No X (deactivation only via toggle)
• Badge icon (media upload) + icon fill color + icon background color: decorative icon circle inside the badge. Note: icon fill/background colors apply via CSS mask – only works with single-color SVG icons. For PNG/JPG or multi-color logos leave both color fields empty.
• Subtitle + show subtitle in badge: short marketing copy under the name (max. 255 chars), e.g. „Next-day delivery“ or „Recycled paper“. Looks best with the badge style Feature Card.
• Hide toggle when active (card „Advanced“): once the badge is active, the toggle disappears from the selection list – the customer can only deactivate via the X on the badge. Reduces visual noise.

Note: subtitle and color also apply in Inline (in toggle) mode – the card is then titled „Inline style (color & icon)“ instead of „Badge Settings“.

Display (card „Display“)

• Size: Compact, Normal or Large – controls the padding/font scale of the badge.
• Position in summary – see the slot list above.
• Display in order confirmation & order overview: In the summary (default) or Prominently at the top. Determines where the option appears on the finish page and in the account area.

Toggle style and zero-price display

• Toggle style (card „Advanced“): Switch (modern on/off) or Checkbox.
• Price display at 0 € (own card): four variants when the calculated price is exactly 0 €:
  • Show „Free“
  • Show „0.00 €“
  • Show nothing
  • Custom text (e.g. „Included“, translatable per language)

Advanced

• Custom CSS class: appended to the badge element – free styling hook for the theme.
• Spacing class (container): Bootstrap spacing utilities (e.g. mt-2 mb-3 or my-1) for vertical spacing relative to the neighbouring option.

Localization

Name, description, subtitle and the custom zero-price text are maintained per language – via the language switcher in the top left of the detail page. Storefront snippets (e.g. toggle labels) can be extended for additional languages via the Shopware snippet system.

Three concrete examples

Example 1: „Express Handling“ as an eye-catching badge

1. Create a new priority option. Name: „Express Handling“. Description: „Your order ships today before 2pm.“
2. Card „General“: Display = Badge.
3. Card „Price“: 4.90 € gross.
4. Card „Display“: Size = Normal, Position in summary = Below shipping.
5. Card „Badge Settings“: Background color = #F47B27 (orange), Text color = #FFFFFF, Badge style = Pill Filled, Close-X behavior = Hover-Blur.
6. Card „Advanced“ (optional): Hide toggle when active = on – the customer deactivates only via the X on the badge.
7. Save – an orange pill badge now appears in the cart below the shipping line as soon as the customer activates the toggle.

Example 2: „Gift Wrapping“ as a regular cart position (Line Item)

1. Create a new priority option. Name: „Gift Wrapping“. Description: „We wrap your order in gift-ready packaging with a ribbon.“
2. Card „General“: Display = Line Item (Default).
3. Card „Price“: 2.90 € gross.
4. Card „Image (toggle cover)“: upload a small gift-icon as the cover.
5. Card „Availability per context“: leave only Available in Cart + Available in Offcanvas Cart active (checkout steps off – the customer should pick this only once in the cart).
6. Save – the option appears as a regular cart row between the products, with the cover icon on the left and the price on the right.

Example 3: „Green Donation“ as a discreet summary row

1. Create a new priority option. Name: „Green Donation“. Description: „1 € goes to reforestation projects, processed by our partner organization.“
2. Card „General“: Display = Summary Row (like Shipping).
3. Card „Price“: 1.00 € gross.
4. Card „Display“: Position in summary = Right before grand total.
5. Card „Advanced“: Toggle style = Checkbox (suits the voluntary-consent character).
6. Save – the option appears in the cart summary like an extra shipping line, directly above the grand total.

Tips

• Keep visual noise low: avoid too many add-ons in the same slot. Three options feel curated; five or more start to feel like a mandatory checklist.
• Badge for premium, summary row for micro-surcharges: higher-priced add-ons (express, preferred date) benefit from the prominent badge mode. Low-priced ones (green donations, tipping) feel more credible as a summary row.
• Test on mobile: the offcanvas cart has less room than the desktop cart page – run through the mobile view before going live.
• Test visibility: when creating a new option, walk through all six context checkboxes deliberately – accidentally hidden contexts are a common source of „add-on does not appear“ tickets.
• Use 0 € with care: for price 0 € the option „Free“ is usually the friendliest display – „0.00 €“ reads bureaucratic.

Uninstall

Under „Extensions → My extensions“ deactivate and then uninstall the plugin. On uninstall you can choose whether the plugin data (all configured options) is kept or deleted.