Swapping a product in subscription means replacing that product with a different one that is offered under the same or compatible subscription plan. Swapped products retain the same quantity as the original product in subscription, but may cause the subscriber to lose, e.g. some product-specific discounts.Product swapping can be used by merchants to periodically switch up what they send with each subscription order, but it can also be used by subscribers to replace, e.g. products they weren’t able to use up with others. As such, product swapping works as a means to combat subscription fatigue.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Juo Subscriptions documentation","colors":{"primary":"#3727F4","light":"#3727F4","dark":"#d9d9d9"},"logo":{"light":"https://mintcdn.com/juo-docs/cLJUw5eiI9OKM0X6/logo/light.svg?fit=max\u0026auto=format\u0026n=cLJUw5eiI9OKM0X6\u0026q=85\u0026s=d41a8b3ca189a0212d8c707309bddacd","dark":"https://mintcdn.com/juo-docs/cLJUw5eiI9OKM0X6/logo/dark.svg?fit=max\u0026auto=format\u0026n=cLJUw5eiI9OKM0X6\u0026q=85\u0026s=29f70ff3ce5c77142a480d3a3f94e08e"},"favicon":{"light":"https://mintcdn.com/juo-docs/yVQsOyGv0SLbx5Dr/favicon.png?fit=max\u0026auto=format\u0026n=yVQsOyGv0SLbx5Dr\u0026q=85\u0026s=d6cb6daa51052383f471eedf80ad8402","dark":"https://mintcdn.com/juo-docs/yVQsOyGv0SLbx5Dr/favicon.png?fit=max\u0026auto=format\u0026n=yVQsOyGv0SLbx5Dr\u0026q=85\u0026s=d6cb6daa51052383f471eedf80ad8402"},"navbar":{"links":[{"href":"mailto:hi@juo.io","label":"Contact us"}],"primary":{"type":"button","label":"Book a demo","href":"https://juo.io/demo"}},"footer":{"socials":{"linkedin":"https://www.linkedin.com/company/juo-io"}},"styling":{"latex":false},"navigation":{"global":{"anchors":[{"anchor":"API","icon":"code","href":"https://juo.dev/"},{"anchor":"Changelog","icon":"newspaper","href":"https://juo.com/changelog"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"juo-docs","hasAudioNarration":false,"actualSubdomain":"juo-docs","customDomains":["juo.io"],"gitSource":{"type":"github","owner":"juo","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6ae49eefab76b29675b215f5","collectionId":"c11c4ea5-7b0f-4ee0-9ece-bde04d69496c","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ae49eefab76b29675b215f5"},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6ae49eefab76b29675b215f5","clientVersion":"0.0.4074","searchFilterCounts":[{"language":"default","tag":"Glossary","count":24},{"language":"default","tag":"Use guide","count":12},{"language":"default","tag":"Workflows","count":8},{"language":"default","tag":"Subscription experiences","count":7},{"language":"default","tag":"Integrations","count":7},{"language":"default","tag":"Settings","count":6},{"language":"default","tag":"Getting started","count":5},{"language":"default","tag":"Use cases","count":3}]},"assistantConfig":{},"basePath":"/docs","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","href":"/docs/_mintlify/custom/juo-docs/67fbaf3080934196/style.css"},{"filePath":"sidebar-scroll-fade.css","content":":root{--scrollbar-size: 8px;--scrollbar-thumb: rgba(0, 0, 0, 0.15);--reveal-speed: 0ms}#sidebar-content{scrollbar-width:thin;scrollbar-color:transparent transparent}#sidebar-content::-webkit-scrollbar{width:var(--scrollbar-size)}#sidebar-content::-webkit-scrollbar-track{background:transparent}#sidebar-content::-webkit-scrollbar-thumb{background-color:transparent;border-radius:calc(var(--scrollbar-size) / 2);transition:background-color var(--reveal-speed)}#sidebar-content:hover,#sidebar-content:active{scrollbar-color:var(--scrollbar-thumb) transparent}#sidebar-content:hover::-webkit-scrollbar-thumb,#sidebar-content:active::-webkit-scrollbar-thumb,#sidebar-content::-webkit-scrollbar-thumb:hover{background-color:var(--scrollbar-thumb)}"}],"page":{"pagePath":"glossary/product-swap","slug":"/glossary/product-swap","pageMetadata":{"title":"Product Swap","description":null,"href":"/glossary/product-swap"},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,p:`p`,..._provideComponents(),...props.components},{Heading,Info}=_components;if(!Heading)_missingMdxReference(`Heading`,true);if(!Info)_missingMdxReference(`Info`,true);return _jsxs(_Fragment,{children:[_jsx(Info,{children:_jsx(_components.p,{children:`Replacing an item in a subscription with a different item.`})}),`\n`,_jsx(Heading,{level:`2`,id:`what-is-a-product-swap`,children:`What is a product swap`}),`\n`,_jsxs(_components.p,{children:[`Swapping a product in `,_jsx(_components.a,{href:`/glossary/subscription`,children:`subscription`}),` means replacing that product with a different one that is offered under the same or compatible subscription plan. Swapped products retain the same quantity as the original product in subscription, but may cause the subscriber to lose, e.g. some product-specific discounts.`]}),`\n`,_jsxs(_components.p,{children:[`Product swapping can be used by merchants to periodically switch up what they send with each `,_jsx(_components.a,{href:`/glossary/subscription-order`,children:`subscription order`}),`, but it can also be used by `,_jsx(_components.a,{href:`/glossary/subscriber`,children:`subscribers`}),` to replace, e.g. products they weren’t able to use up with others. As such, product swapping works as a means to combat subscription fatigue.`]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Product Swap","description":null,"href":"/glossary/product-swap"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"What is a product swap","slug":"what-is-a-product-swap","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"juo-docs","siteName":"Juo Subscriptions documentation","title":"Product Swap - Juo Subscriptions documentation","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-30T13:35:54.044Z","originalFileLocation":"glossary/product-swap.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"application-name\" content=\"Juo Subscriptions documentation\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/juo-docs/M-CEz_Bq6naV5nJf/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/docs/mintlify-assets/_mintlify/favicons/juo-docs/M-CEz_Bq6naV5nJf/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/juo-docs/M-CEz_Bq6naV5nJf/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/juo-docs/M-CEz_Bq6naV5nJf/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/juo-docs/M-CEz_Bq6naV5nJf/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/juo-docs/M-CEz_Bq6naV5nJf/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/juo-docs/M-CEz_Bq6naV5nJf/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/juo-docs/M-CEz_Bq6naV5nJf/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/juo-docs/M-CEz_Bq6naV5nJf/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Product Swap - Juo Subscriptions documentation\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Juo Subscriptions documentation\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://juo.io/docs/glossary/product-swap\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://juo-docs.mintlify.site/docs/_mintlify/api/og/v2?division=Glossary\u0026amp;title=Product+Swap\u0026amp;theme=744beef7a106f2cad03d3b03\u0026amp;signature=6eb75f6b3e881c396732a047f3a877be1ae8a550ce3020cb76615262b40880d1\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Product Swap - Juo Subscriptions documentation\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://juo-docs.mintlify.site/docs/_mintlify/api/og/v2?division=Glossary\u0026amp;title=Product+Swap\u0026amp;theme=744beef7a106f2cad03d3b03\u0026amp;signature=6eb75f6b3e881c396732a047f3a877be1ae8a550ce3020cb76615262b40880d1\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/docs/mintlify-assets/_mintlify/favicons/juo-docs/M-CEz_Bq6naV5nJf/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Juo Subscriptions documentation\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#3727F4\">\u003clink data-mint-head rel=\"canonical\" href=\"https://juo.io/docs/glossary/product-swap\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/docs/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/docs/glossary/product-swap.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://juo.io/#organization\",\"name\":\"Juo Subscriptions documentation\",\"url\":\"https://juo.io\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/juo-docs/cLJUw5eiI9OKM0X6/logo/light.svg?fit=max\u0026auto=format\u0026n=cLJUw5eiI9OKM0X6\u0026q=85\u0026s=d41a8b3ca189a0212d8c707309bddacd\"}},{\"@type\":\"WebSite\",\"@id\":\"https://juo.io/docs#website\",\"name\":\"Juo Subscriptions documentation\",\"url\":\"https://juo.io/docs\",\"publisher\":{\"@id\":\"https://juo.io/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://juo.io/docs/glossary/product-swap#webpage\",\"url\":\"https://juo.io/docs/glossary/product-swap\",\"name\":\"Product Swap\",\"dateModified\":\"2026-10-30T13:35:54.044Z\",\"isPartOf\":{\"@id\":\"https://juo.io/docs#website\"},\"breadcrumb\":{\"@id\":\"https://juo.io/docs/glossary/product-swap#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://juo.io/docs/glossary/product-swap#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\" \",\"item\":\"https://juo.io/docs/glossary/build-a-box\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Glossary\",\"item\":\"https://juo.io/docs/glossary/build-a-box\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Product Swap\",\"item\":\"https://juo.io/docs/glossary/product-swap\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://juo.io/docs/glossary/product-swap#article\",\"headline\":\"Product Swap\",\"name\":\"Product Swap\",\"url\":\"https://juo.io/docs/glossary/product-swap\",\"mainEntityOfPage\":{\"@id\":\"https://juo.io/docs/glossary/product-swap#webpage\"},\"dateModified\":\"2026-10-30T13:35:54.044Z\",\"publisher\":{\"@id\":\"https://juo.io/#organization\"},\"isPartOf\":{\"@id\":\"https://juo.io/docs#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Juo Subscriptions documentation\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Juo Subscriptions documentation","nav":{"global":{"anchors":[{"anchor":"API","icon":"code","href":"https://juo.dev/"},{"anchor":"Changelog","icon":"newspaper","href":"https://juo.com/changelog"}]},"groups":[{"group":"Getting started","pages":[{"title":"Intro","href":"/index"},{"title":"About Juo","href":"/about-juo"},{"title":"Use Juo with an AI assistant","sidebarTitle":"Juo MCP","href":"/use-juo-with-ai"},{"title":"Subscription experiences","href":"/subscription-experiences"},{"title":"Retention","href":"/retention"}]},{"group":"Subscription experiences","pages":[{"title":"Subscribe and save","href":"/subscribe-and-save"},{"title":"Build-a-box","href":"/build-a-box"},{"title":"Upsells","href":"/upsells"},{"title":"Extras","href":"/extras"},{"title":"Custom workflows","href":"/custom-workflows"},{"title":"Curated boxes","href":"/curated-boxes"},{"title":"Memberships","href":"/memberships"}]},{"group":"Workflows","pages":[{"title":"Workflows overview","sidebarTitle":"Overview","href":"/workflows/workflows-overview"},{"title":"Triggers","href":"/workflows/triggers"},{"title":"Conditions","href":"/workflows/conditions"},{"title":"Actions","href":"/workflows/actions"},{"title":"Experiments (A/B tests)","sidebarTitle":"Experiments","href":"/workflows/experiments"},{"group":"Use cases","pages":[{"title":"Cancellation flow","href":"/workflows/guides/cancellation-flow"},{"title":"Fight new subscriber churn","href":"/workflows/guides/fight-new-subscriber-churn"},{"title":"VIP rewards","href":"/workflows/guides/vip-rewards"}]}]},{"group":"Settings","pages":[{"title":"General settings","href":"/general-settings"},{"title":"Retention and acquisition settings","sidebarTitle":"Retention settings","href":"/retention-flow"},{"title":"Shipping setup","href":"/shipping-setup"},{"title":"Notifications","href":"/notifications"},{"title":"SID conversion engine","href":"/subscription-intent-detection"},{"title":"SEPA chargebacks recovery","href":"/sepa-chargebacks"}]},{"group":"Integrations","pages":[{"title":"Klaviyo","href":"/klaviyo-integration"},{"title":"Hubspot","href":"/hubspot-integration"},{"title":"Customer.io","href":"/customerio-integration"},{"title":"Gorgias","href":"/gorgias-integration"},{"title":"Zipify","href":"/zipify-integration"},{"title":"Webhooks","href":"/webhooks"},{"title":"Leat","href":"/leat-integration"}]},{"group":"Use guide","pages":[{"title":"Editor","sidebarTitle":"Editor","href":"/editor"},{"title":"Managing subscriptions","href":"/managing-subscriptions"},{"title":"Create a subscription","href":"/create-subscription"},{"title":"Bulk actions","href":"/bulk-actions"},{"title":"Using Customer Portal","href":"/customer-portal"},{"title":"Customer Portal link","href":"/linking-customer-portal"},{"title":"Quick actions","href":"/quick-actions"},{"title":null,"href":"/discounts"},{"title":"Tiered discounts","href":"/tiered-discounts"},{"title":"Subscription widget","href":"/adding-juo-subscription-widget"},{"title":"Customize widget","href":"/subscription-widget"},{"title":"Build a custom subscription storefront","sidebarTitle":"Custom storefront","href":"/custom-storefront"}]},{"group":" ","pages":[{"group":"Glossary","pages":[{"title":"Build A Box","href":"/glossary/build-a-box"},{"title":"Customer Portal","href":"/glossary/customer-portal"},{"title":"Delivery Frequency","href":"/glossary/delivery-frequency"},{"title":"Dunning","href":"/glossary/dunning"},{"title":"Dynamic Boxes","href":"/glossary/dynamic-boxes"},{"title":"Email Notifications","href":"/glossary/email-notifications"},{"title":"Inventory Policy","href":"/glossary/inventory-policy"},{"title":"Lifetime Value","href":"/glossary/lifetime-value"},{"title":"Membership","href":"/glossary/membership"},{"title":"Merchant Portal","href":"/glossary/merchant-portal"},{"title":"Migration","href":"/glossary/migration"},{"title":"One Time Purchase","description":null,"href":"/glossary/one-time-purchase"},{"title":"Product Swap","href":"/glossary/product-swap"},{"title":"Retention Flow","description":null,"href":"/glossary/retention-flow"},{"title":"Skip Renewal","href":"/glossary/skip-renewal"},{"title":"Stock Keeping Unit","href":"/glossary/stock-keeping-unit"},{"title":"Subscriber","href":"/glossary/subscriber"},{"title":"Subscription Box","href":"/glossary/subscription-box"},{"title":"Subscription Cancellation","href":"/glossary/subscription-cancellation"},{"title":"Subscription Order","href":"/glossary/subscription-order"},{"title":"Subscription Pause","href":"/glossary/subscription-pause"},{"title":"Subscription Renewal","href":"/glossary/subscription-renewal"},{"title":"Subscription","href":"/glossary/subscription"},{"title":"Variable Discount","href":"/glossary/variable-discount"}]}]}]},"basePath":"","title":"Product Swap - Juo Subscriptions documentation","buildId":"dpl_CEsowfH15TDzsBT2BFbX312Be4Ct","deploymentId":"dpl_CEsowfH15TDzsBT2BFbX312Be4Ct","dynamics":[],"chunks":[]}