# MedusaJS ## Add Zigpoll to Your MedusaJS Storefront MedusaJS is an open-source headless commerce platform built on Node.js. Since MedusaJS storefronts are fully custom (typically Next.js or Gatsby), adding Zigpoll is as simple as embedding a script tag in your storefront code. *** ### What you'll need * Your **Zigpoll Account ID** (find it in Zigpoll → Settings → Installation) * Access to your **MedusaJS storefront codebase** (e.g., your Next.js project) *** ### Step 1: Get your Zigpoll embed code 1. Log in to your [Zigpoll dashboard](https://app.zigpoll.com). 2. Go to **Settings → Installation**. 3. Copy your **Account ID**. *** ### Step 2: Add the Zigpoll script to your storefront Since MedusaJS storefronts are custom-built, you'll add the Zigpoll embed script directly in your storefront code. Below are examples for the most common setups. #### Next.js storefront (App Router) Open your root layout file (e.g., `app/layout.tsx`) and add the Zigpoll script: ```tsx import Script from 'next/script'; export default function RootLayout({ children }: { children: React.ReactNode }) { return ( {children} ``` > Replace `YOUR_ACCOUNT_ID` with your actual Zigpoll Account ID. *** ### Step 3: Configure display rules Back in the Zigpoll dashboard, set your survey's **Display Rules** to control when and where surveys appear: * **All pages** — sitewide polls, exit intent, timed popups * **Specific URLs** — target checkout, product, or landing pages * **Post-purchase** — show surveys on your order confirmation page *** ### (Optional) Post-purchase surveys with order data To run post-purchase surveys on your MedusaJS order confirmation page, pass order metadata to Zigpoll. Add this script on your order confirmation/thank-you page: ```tsx import Script from 'next/script'; // Assumes `order` is available from your page props or API call export default function OrderConfirmation({ order }) { const zigpollScript = ` ;(function () { window.Zigpoll = { accountId: 'YOUR_ACCOUNT_ID' }; window.Zigpoll.user = { id: '${order.email}', metadata: { email: '${order.email}', name: '${order.shipping_address?.first_name || ""} ${order.shipping_address?.last_name || ""}'.trim(), city: '${order.shipping_address?.city || ""}', country: '${order.shipping_address?.country_code || ""}' } }; window.Zigpoll.metadata = { orderId: '${order.id}', orderValue: '${order.total}', lineItems: ${JSON.stringify((order.items || []).map(i => i.title))} }; var precursorEvent = window.Zigpoll.precursorEvent || {}; precursorEvent.type = 'medusajs-order-placed'; precursorEvent.uniqueId = '${order.id}'; window.Zigpoll.precursorEvent = precursorEvent; var script = document.createElement("script"); script.type = "text/javascript"; script.charset = "utf-8"; script.src = "//cdn.zigpoll.com/static/js/main.js"; document.head.appendChild(script); }()); `; return (

Thank you for your order!

{/* ... your order confirmation content ... */}