Settings

General, Advanced and Tools

7 min read

Settings has a menu on the left with five sections: General, Widget style, Text & languages, Advanced and Tools. Each shows a one-line summary under its name. This page covers General, Advanced and Tools. For Widget style, see Style Customizer; for Text & languages, see Text & languages.

Changes are saved with Save settings at the top of the page. A bundle's own settings always win over these store-wide defaults.

#General

General sets the defaults for new bundles and how bundles behave in the cart. Most merchants set it once and move on.

#New bundles start with

The discount every new bundle starts with: Percentage off, Amount off, Set price or No discount, and its value. You can change it on each bundle.

#When more than one bundle fits a product

Only one bundle shows on a product page. Choose which:

You choose the order: each bundle has a priority number (the Bundle priority card in the editor). The highest wins.
Biggest saving wins: the bundle with the largest discount shows.

#Cart and checkout

Setting	Default	What it does
`After "Add to cart"`	Do what my theme does	Where the shopper goes next: your theme's usual behaviour, the cart page, checkout, or stay on the page.
`Bundles per order`	0	How many bundles one cart can hold. 0 means no limit. Volume discounts aren't limited.
`Block the bundle when a product is sold out`	On	The button turns off if any item in the bundle is out of stock.
`Show savings in the cart`	On	A line in the cart tells shoppers how much the bundle saved them.
`Combine with other discounts`	Off	Bundle discounts combine with discount codes and automatic discounts.
`Hide express checkout buttons`	Off	Hides Shop Pay, PayPal, Apple Pay and similar buttons, so shoppers can't skip the bundle discount. Product and cart pages only; checkout isn't affected.

#Analytics

Track bundle views, add-to-carts and sales (on by default) feeds the Analytics page. Turn it off if you only use another analytics tool.

#When to change these

Set the discount you use most so every new bundle starts there.
For BFCM or a flash sale, keep Combine with other discounts off so codes don't stack on the bundle discount. Turn it on if you want them to stack.
Turn off tracking if your privacy policy doesn't cover the app's analytics.
Set Bundles per order to 1 or 2 on high-discount promotions.

#Text & languages

Every word the widget and cart show to shoppers, and their translations, are on their own page: Text & languages.

#Advanced

Advanced has two cards: Custom CSS for changes the style editor can't make, and Speed. If you don't have CSS knowledge, leave it alone. The Style Customizer covers visual customization without touching code. See Style Customizer.

#Custom CSS

Field	Default	Limit	Notes
`Extra class on the widget`	(empty)	100 characters	Adds a class to the bundle widget's outer container. Use it to target the widget from your theme's own stylesheet without writing CSS in the app.
`CSS`	(empty)	10,000 characters	Raw CSS injected into every page where the bundle widget loads. Start selectors with `.radius-bundle-widget` or use the custom class above.

The CSS editor highlights syntax and marks errors as you type. Press Tab to indent; press Esc, then Tab, to leave the editor. Your CSS loads after the widget's own styles. It applies to all bundles across your storefront. If you need styles that vary by bundle, use the custom CSS class to scope selectors.

The CSS isn't saved while it has problems. The status above the editor reads No problems, Empty or the number of problems, and a "Not saved. Fix these first:" list names each one by line:

A selector that styles your whole store, such as html, body, :root or *. Start it with .radius-bundle-widget or your extra class instead.
Text that isn't CSS.
A { that is never closed, or a } with no rule to close.

Custom CSS with two problems: a body selector and an unclosed brace, listed under Not saved. Fix these first

#Speed

Refresh bundle data on the storefront sets how long shoppers' browsers cache bundle prices and stock: Every visit, 1 min, 5 min (recommended), 15 min or 1 hour. Shorter means fresher data; longer means faster pages. The note under the slider says how soon a change appears on your store.

Load product images as shoppers scroll (on by default) waits to load images until they come into view, so the page appears faster.

#When to change these

If prices or stock change often, set refresh to 1 min or Every visit.
If your theme's CSS is overriding widget styles, add a custom class and use it as a higher-specificity selector.
To match your store font, override font-family on the widget container in the CSS field.
For styling the Style Customizer doesn't cover, use the CSS field.

#Tools

Tools is for troubleshooting, backups and resets. Visit it when something on the storefront doesn't match what you set in the app.

#Fix common problems

Run a check is the one button to press before contacting support. It resends your bundles and settings to Shopify, checks the webhooks, registers any that are missing, and clears the caches.

A Check result dialog then says All good. or Some steps failed., and a summary line: how many bundles were synced, how many webhooks are active, any registered again, and that the caches were cleared, for example "17 bundles synced · 12 of 12 webhooks active · caches cleared." If a step failed, it names it and points you to the manual tools. The Tools item in the Settings menu shows the last result, for example "Last check: all good".

Check result: All good, with bundles synced, webhooks active and caches cleared

#Manual tools

Open Manual tools to run each step on its own:

Tool	What it does
`Sync to Shopify`	Resends all bundles and settings to your store, and turns the Radius Bundles discount back on if it was switched off in Shopify.
`Clear caches`	Shoppers and this page see your latest changes straight away.
`Check webhooks`	Shows which Shopify updates the app is receiving.
`Register webhooks again`	Reconnects order, product and stock updates from Shopify. Use it when the check shows something missing.

After a sync, a dialog confirms your store is up to date and shows the active bundles, the products linked, and the discounts it updated or found already right. If some products had to be skipped because their discount setup was too large for Shopify, the dialog says how many; those products get no bundle discount until the bundle's product list is trimmed.

The dialog can also show a note:

Products no longer in an active bundle were cleared.
The app's discount was missing from Shopify and has been recreated.
No discounts were written although bundles are active, so they won't discount at checkout. Run the sync again, and contact support if it stays.

The webhook check lists each update by area (Products, Stock, Orders, Store, App) with a tick when it's connected. Privacy requests are set by Shopify and always on.

In normal operation you won't need the webhook tools. Reach for them if product deletions are not pausing bundles, or orders aren't being counted.

#Backup

Action	What it does
`Download settings`	Downloads a file of every setting and text. Bundles are exported from the Bundles page instead.
`Restore from a file`	Replaces your current settings with the ones in a downloaded file.

Download a backup before large changes (style, text, general settings), or to move your settings to another store.

#Reset all settings

Reset... puts every setting and text back to the default. Your bundles are not deleted. It can't be undone, so download a backup first. A confirmation dialog opens before anything changes.

#When to use Tools

If a scheduled bundle doesn't show on the storefront after you activate it, run Sync to Shopify (or Run a check) to push the latest state.
After bulk-editing bundles, sync to confirm all changes are live.
If a discount isn't applying, run a sync and test checkout again before contacting support. If the Radius Bundles discount was switched off in Shopify, sync reactivates it automatically.
If the "Bundle discounts are turned off" banner appears, run a sync or click Reactivate discount on the banner (see Bundle discount is turned off in Shopify).
If the widget shows stale products or prices, run a sync and reload the product page in an incognito window.
If the app or storefront shows stale data, use Clear caches and reload.
If webhooks appear to be misfiring, use Check webhooks first, then Register webhooks again if something is missing.
Before large changes to settings, use Download settings as a backup.