PPS Order Bump: settings reference

Updated November 10, 2026

Set the bump product and offer text in WooCommerce > Order Bump before enabling the checkout offer.

Release in preparation. This reference is not confirmation of download or Pro purchase availability.

Choose a purchasable bump product before enabling the checkout offer. This is an opt-in cart addition, not a preselected charge.

Where to configure it

WooCommerce > Order Bump. The menu and save handler require manage_woocommerce. Use Save Changes after editing.

Initial form values and unsaved runtime values can differ. The tables distinguish them instead of treating an unchecked form as an enabled setting. For checkbox groups, choose each method/day/location you want before the first save.

The offer

Field Initial form / unsaved runtime Allowed input and save fallback Access Effect
Enable (enabled) Form: blank; runtime: unchecked On/off. Unchecked saves false. Free Show the bump offer at checkout.
Bump product ID (bump_product_id) 0 Number; min 0; UI step 1. Save casts to float and clamps to the stated bounds. Blank uses 0. Free The product offered in the box (warranty, accessory, gift wrap…).
Badge text (badge_text) ONE TIME OFFER Text; stripped of markup on save. Free Sets badge text for this section. See the behavior notes for its conditions.
Headline (headline) Add Premium Protection Text; stripped of markup on save. Free Sets headline for this section. See the behavior notes for its conditions.
Checkbox label (checkbox_label) Yes, add this for {price}! Text; stripped of markup on save. {price} shows the (discounted) bump price. Free {price} shows the (discounted) bump price.
Description (description) blank Multiline text; stripped of markup on save. Free Sets description for this section. See the behavior notes for its conditions.
Attention arrow (flashing_arrow) checked On/off. Unchecked saves false. Free A pulsing arrow pointing at the checkbox.

Discount and placement (Pro)

Field Initial form / unsaved runtime Allowed input and save fallback Access Effect
Bump discount (discount_type) none none = No discount; percentage = Percentage off; fixed = Fixed amount off. Invalid input uses none. Pro field; save skipped without Pro Sets bump discount for this section. See the behavior notes for its conditions.
Discount value (discount_value) 0 Number; min 0; UI step 0.01. Save casts to float and clamps to the stated bounds. Blank uses 0. Pro field; save skipped without Pro Sets discount value for this section. See the behavior notes for its conditions.
Position at checkout (position) before_submit before_submit = Right above the place order button; before_payment = Above the payment methods; after_order = After the order review. Invalid input uses before_submit. Pro field; save skipped without Pro Sets position at checkout for this section. See the behavior notes for its conditions.

Box design

Field Initial form / unsaved runtime Allowed input and save fallback Access Effect
Box background (box_bg) #fefce8 Hex color (#RGB or #RRGGBB). Invalid/blank saves #fefce8. Free Sets box background in this section; it does not change other plugin colors.
Border color (box_border_color) #ef4444 Hex color (#RGB or #RRGGBB). Invalid/blank saves #ef4444. Free Sets border color in this section; it does not change other plugin colors.
Border style (box_border_style) dashed dashed = Dashed; solid = Solid; dotted = Dotted. Invalid input uses dashed. Pro field; save skipped without Pro Sets border style for this section. See the behavior notes for its conditions.
Badge background (badge_bg) #ef4444 Hex color (#RGB or #RRGGBB). Invalid/blank saves #ef4444. Free Sets badge background in this section; it does not change other plugin colors.
Badge text (badge_text_color) #ffffff Hex color (#RGB or #RRGGBB). Invalid/blank saves #ffffff. Free Sets badge text in this section; it does not change other plugin colors.
Text color (text_color) #000000 Hex color (#RGB or #RRGGBB). Invalid/blank saves #000000. Free Sets text color in this section; it does not change other plugin colors.

Behavior and edition boundaries

Use a simple product ID or a fully specified variation ID, not an unresolved variable parent. Enable is off and the ID is zero initially. The offer is one unit; it is hidden if that item already exists as an ordinary cart line. Current purchasability, stock, shared stock demand and native insertion validation apply. Toggle requests require both the REST nonce and current session-bound cart nonce. A rejected add is not reported as a successful order addition.

The {price} placeholder uses the effective checkout cart tax display, including tax exemption and cart filters, not the shop price-display option. The configured discount is applied to a raw catalog/current eligible base before display tax is calculated. WooCommerce checkout still governs tax and totals. This is a Classic Checkout hook integration; Blocks support and installed-store tax acceptance are not established.

Repeated totals use a request-local per-product price-ownership ledger. Disabling, changing the target, losing Pro or becoming ineligible restores only a still-owned mutation on the next totals pass. Distinct later foreign writes survive; equal-valued foreign writes cannot be identified. It is not a shared pricing lock or proof of interoperability with every discount plugin. Pro owns percentage/fixed discounts, alternate placement and border-style callbacks; Free has the sole toggle/cart engine and ordinary undiscounted offer.

Free uses the before-submit position, dashed border and regular product price. Pro branches supply other positions, border styles and percentage/fixed discounts. The displayed checkbox label can include {price}.

Pro field access depends on the add-on and its licensing gate. Freemius account or license screens are separate from frontend rendering; opening an account page does not establish that a feature rendered.

Troubleshooting

Shopper controls

The checkout offer checkbox is the shopper control, not another admin setting. Its state reflects whether the bump is already in the cart. Changing it sends the new checked state to the same-site handler, then refreshes checkout totals. A failed request restores the previous checkbox state. The offer must still be a purchasable product; checking the box is not an order-payment confirmation.

Checks

A missing bump can mean product ID 0, an unavailable product or a checkout template that does not fire the classic WooCommerce hook. Do not assume this classic-hook integration supports block checkout.

Disable or roll back safely

Record the current values before changing them. Clear Enable and save to stop new module output/actions. Revert one setting at a time. Deactivation is not an undo of cart changes, sent messages, created orders or saved records. Avoid uninstalling as a rollback, since uninstall may remove data. Back up the database before a data-changing rollback.

Services and data

A same-site endpoint adds or removes the marked bump cart item. Discount calculations run on cart totals, not just the displayed label.

Account, licensing and updater traffic must be reviewed separately. This reference does not claim that all data stays local or that a service connection has been tested.

Related documentation

Setup: https://propluginstack.com/docs/order-bump-setup-reference/

Changelog: https://propluginstack.com/changelog/order-bump-source-changelog/