Getting started

Installing Radius Bundles

2 min read

Radius Bundles installs from the Shopify App Store. The process takes under two minutes.

#Before you install

You need:

A Shopify store (any plan)
Store owner or admin access (staff accounts with limited permissions may not be able to install apps)

#Installation steps

Go to the Radius Bundles listing on the Shopify App Store.
Click Add app.
Shopify redirects you to your store's admin for confirmation. Review the permissions and click Install app.
The app installs and opens to the dashboard automatically.

#Permissions the app requests

Shopify shows a list of permissions before you confirm:

Why it's needed	Permission
Read your product catalog so you can pick products when building a bundle	`read_products`
Create a Shopify product when you use the "Bundle as Product" feature	`write_products`
Register the discount function that applies bundle pricing at checkout	`write_discounts`
Track bundle purchases for analytics	`read_orders`
Check whether the app embed and widget block are active in your theme	`read_themes`
Publish or unpublish the bundle product to sales channels	`write_publications`
Enable the storefront widget to fetch bundle data and record view events	`write_app_proxy`
Upload bundle images	`write_files`
Detect store languages so widget labels can be served in the correct locale	`read_locales`

The app does not read or write customer personal data, payment information, or any data outside the scopes listed above.

#What happens after install

The app creates a shop record in its database and sets up background connections to keep your data in sync.

You land on the Dashboard. A strip at the top shows your progress (for example 5/6), the next step, and a button to open it. Click Show all steps to see the full setup guide, or Setup guide at the top of the page. It has six steps:

Turn on the app embed: enables the global scripts your widget and discounts need
Create your first bundle: creates the offer shoppers will see
Add the bundle widget: places the visible widget on a product page template
Make it yours: customize colors, fonts, and layout (optional)
See it live: preview the bundle on your storefront (optional)
Keep an eye on performance: open the analytics dashboard (optional)

Steps 1–3 must all be completed before a bundle appears to shoppers.

Dashboard showing the setup guide with steps listed

When the setup guide isn't showing, a yellow banner on the dashboard warns you if the app embed is off ("App embed is not enabled"), the widget isn't on a product page ("Bundle widget not added to your theme"), or both ("Theme setup incomplete"). Its button opens the theme editor at the right place. See widget-setup.md for those steps.

Below the guide, the dashboard shows your bundle revenue, conversion rate, views and active bundles for the chosen date range, your top bundles, anything that needs attention, and tutorial videos for each bundle type. If there's been a version update since your last visit, a What's new popup opens automatically to show what changed.

The app's own screens follow your Shopify admin language: English, German, Spanish, French, Italian, Japanese or Brazilian Portuguese. Other admin languages show the app in English.

#Next step

Create your first bundle: a 5-minute walkthrough from open app to live on storefront.