Getting started guide
Install Nudge, connect your store, and verify the assistant is live in your theme.
- Install Nudge from the Shopify App Store and approve required scopes.
- Open the onboarding wizard in Shopify Admin and complete the four setup steps.
- Enable the Nudge app embed in your active theme and save changes.
- Send a test message from your storefront to confirm product search and cart actions work.
- Review analytics after first conversations to verify tracking is active.
Implementation checklist
- Store installed and active
- Widget visible on desktop and mobile
- First conversation completed
- Analytics dashboard receiving data
installonboardingshopify apptheme app extensionsetupgo live
Widget configuration
Configure colours, widget position, and welcome copy so Nudge matches your brand.
- Use the Widget Settings screen to choose your primary colour and panel position.
- Set a concise welcome message that explains the assistant can help with products and cart actions.
- Use the built-in preview to check contrast and readability before publishing.
- If you run experiments, prefer one variable change at a time for cleaner analysis.
Implementation checklist
- Colour contrast passes accessibility checks
- Widget placement avoids overlap with other fixed UI
- Welcome message reflects your store voice
appearancecolourpositionwelcome messagebrandingpreview
Assistant personality setup
Tune the assistant tone and behavioural guidance for your brand voice and support style.
- Choose the baseline tone that best matches your brand: friendly, professional, or concise.
- Add store context such as shipping expectations, return policy summaries, and current promotions.
- Avoid highly prescriptive scripts; short policy guardrails produce more natural conversations.
- Re-test personality settings whenever major campaigns or seasonal messaging changes.
Implementation checklist
- Tone setting selected
- Policy and promotion context reviewed
- Sample prompts validated by your team
tonepersonalitybrand voicepromptconversation style
Billing and usage
Understand subscription charges, usage-based billing, and key spend controls.
- Nudge bills through Shopify's Billing API with subscription and usage components in USD.
- For merchants billed in other currencies, Shopify handles invoice conversion and the admin dashboard shows localised approximate equivalents.
- Usage records are created on completed sessions and reconcile through Shopify billing cycles.
- Cost controls include plan session caps and automatic guardrails when spend approaches limits.
- Use the analytics dashboard to track assisted revenue, conversion rate, and ROI.
Implementation checklist
- Plan tier confirmed
- Usage cap behaviour reviewed
- ROI metrics checked weekly
pricingusage recordsshopify billingcost controlsroiplans
FAQ
Quick answers to common setup, privacy, and storefront behaviour questions.
- Does Nudge replace Shopify checkout? No, checkout always remains on Shopify hosted checkout pages.
- How long are chats stored? Conversation data is retained for up to 24 hours, then deleted.
- Does the assistant support multiple languages? Yes, the assistant handles multilingual customer conversations natively.
- Can I run A/B tests? Yes, Nudge supports experiments for placement, welcome message, and personality tone.
frequently asked questionsprivacylanguagesmobilecheckoutattribution
Troubleshooting
Diagnose common issues with widget visibility, API responses, and checkout attribution.
- If the widget is missing, verify the app embed is enabled in the published theme.
- If responses fail, check store status in admin and confirm Storefront API access token validity.
- If add-to-cart fails, inspect variant availability and ensure products are purchasable on the Online Store channel.
- If conversions are missing, confirm order webhooks are installed and cart attribution keys are present.
Implementation checklist
- Theme app embed is active
- Storefront token is valid
- Webhook delivery status is healthy
debuggingwidget not showingapi errorsrate limitscheckout trackingsupport
Merchant privacy policy update guidance
Template guidance for updating your store privacy policy when enabling an AI shopping assistant.
- State that your storefront uses an AI shopping assistant to process customer messages.
- Disclose that conversation data may be processed by sub-processors for response generation and hosting.
- Explain retention clearly: conversations are short-lived and deleted on a rolling 24-hour basis.
- Note that a strictly necessary session cookie is used to maintain conversation continuity.
- Link your policy to Nudge privacy resources so customers can review processor and retention details.
Implementation checklist
- Privacy policy includes AI assistant disclosure
- Cookie disclosure includes session cookie purpose
- Store contact channel for privacy requests is published
merchant privacy policypolicy updatesdisclosurecookie consentai assistant