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/