How to install Nudgesmart on your Shopify store

TL;DR

Open the Nudgesmart listing on the Shopify App Store, click Add app, and approve the requested permissions. Shopify redirects you to the embedded Nudgesmart admin where you'll see a Welcome to Nudgesmart screen with a setup guide and a template gallery. To confirm the install worked, look at the Enable Theme Extension step in the setup guide — a green checkmark means your storefront is connected and you're ready to ship a campaign. If it isn't green yet, click Enable in Theme Editor, click Save in the theme editor, and the install is complete.

Before you begin

You'll need three things and about three minutes.

• A Shopify store on any plan. Nudgesmart works on Basic and up — there are no Plus-only features in the install path.
• Permission to install apps. You must be the store owner or a staff member with Apps and channels access. Shopify's staff permissions documentation covers this if you're unsure.
• A live theme using Online Store 2.0. Every theme in the Shopify Theme Store qualifies, plus the vast majority of paid third-party themes built since June 2021.

Step 1 · Open the Nudgesmart App Store listing

Nudgesmart App Store listing page header with the Add app button

Screenshot coming soon

Take a moment to review the screenshots, pricing, and the What this app can access section, which lists every Shopify scope the app will request. When you're ready to proceed, click Add app in the top-right corner. Shopify will ask you which store to install on if you're signed into more than one.

Step 2 · Approve the requested permissions

Shopify permissions screen showing the Nudgesmart scope list

Screenshot coming soon

Nudgesmart asks for the minimum scopes required to operate as a campaign-management platform. Specifically:

• read_products and read_files — used to render product carousels and image content inside popups.
• read_customers and write_customers — used to suppress popups for known logged-in customers and to capture email subscribers from email-capture campaigns.
• read_orders — used to power conversion tracking on the campaign analytics dashboard.
• read_themes — used to verify your live theme exposes the Nudgesmart app embed block.
• read_discounts and write_discounts — used by spin-wheel and coupon-reward campaigns to issue real Shopify discount codes.
• read_marketing_events and write_marketing_events — used to log popup impressions and conversions in your Shopify Marketing reports.
• read_app_proxy and write_app_proxy — used by the storefront-side scripts to authenticate POST requests back to the Nudgesmart admin.

Nudgesmart never modifies theme files, never reads order line-item personally identifiable information beyond what's required for conversion attribution, and never sends merchant data to third parties without explicit consent. For a deeper reference on how Shopify scopes work, see the official Shopify access scopes documentation.

Step 3 · Land on the Welcome dashboard

Welcome to Nudgesmart screen showing the setup guide checklist, Choose Your Campaign Template gallery, and free-trial banner

Screenshot coming soon

The Welcome dashboard shows three things at first load: a setup guide that walks through enabling the theme extension and shipping your first campaign, a Choose Your Campaign Template gallery so you can launch a high-converting popup in minutes, and a free-trial banner explaining that all paid plans include a 14-day free trial with no charge until the trial ends. Pricing details for each plan are on the Nudgesmart pricing page.

The setup guide is the simplest way to confirm everything is working. Look at the Enable Theme Extension step — if it shows a green checkmark and "Nudgesmart is enabled in your theme," your storefront is fully connected. If it doesn't, click Enable in Theme Editor — Shopify opens the theme editor with the Nudgesmart extension pre-selected, and you just click Save. Come back to the setup guide and click Check Status to confirm.

Common pitfalls

• The setup guide says the theme extension isn't enabled. Click Enable in Theme Editor in the setup guide — Shopify opens the theme editor with the Nudgesmart extension pre-selected. Click Save in the top-right corner of the theme editor, then return to the Nudgesmart admin and click Check Status. The walkthrough article covers this step in more detail: Enable the Nudgesmart app embed block.
• You see a redirect loop after install. This usually means a third-party Chrome extension (an ad blocker or privacy extension) is blocking Shopify's session cookies. Try installing from an Incognito window with extensions disabled.
• The app installed but the embedded admin won't load. Clear your browser cache for admin.shopify.com and reload. If the issue persists, see troubleshooting the embedded admin.
• You're missing a scope you expected to see. Shopify occasionally updates how scopes are displayed in the consent screen. Cross-reference what's on screen against the canonical list in Step 2 above — if anything doesn't match, contact support before approving.

Frequently asked questions

Will installing Nudgesmart slow down my storefront?

No. Nudgesmart loads conditionally — when no campaigns are active for a visitor, zero JavaScript is shipped to your storefront beyond the inline campaign-fetch request. With active campaigns, the script bundles are heavily code-split and load asynchronously after the rest of your page is interactive.

Can I uninstall Nudgesmart cleanly?

Yes. Go to Shopify admin → Apps → Nudgesmart → Uninstall. Shopify automatically revokes scopes and removes the Nudgesmart app embed block from your theme. Merchant data is deleted within 48 hours, in line with Shopify's protected customer data policy.

Does Nudgesmart work on my theme?

If your theme supports Online Store 2.0 (released June 2021), yes. Every theme in the Shopify Theme Store qualifies, plus most paid third-party themes built since 2021. Older Online Store 1.0 themes are not supported because they don't expose the app-embed-block extension surface.

What to read next

• Help

  How to enable the Nudgesmart app embed block in your theme

  Turn on the Nudgesmart app embed inside your Shopify theme so popups can render on your storefront.

• Help

  How to create your first popup from a Nudgesmart template

  Pick a template from the gallery, customize the text and image, and publish your first popup in under five minutes.

• Help

  A tour of the Nudgesmart dashboard

  Walk through every section of the Nudgesmart dashboard so you know where campaigns, analytics, templates, and settings live.