Renewal is an automatic or manual extension of an active subscription that causes a new subscription order to be placed. Renewal marks the beginning of a new subscription cycle and allows to keep the subscription for the length of that cycle (provided it’s not canceled manually before the cycle ends).Renewals only occur in subscriptions, subscription boxes, and memberships, which sets them apart from regular, one-time orders.
There are two types of renewal: automatic and manual.Automatic renewals or auto-renewals allow for a subscription to be automatically renewed at the beginning of each subscription cycle. Thanks to that, a subscription will continue to be active and the subscriber will keep access to their subscription products or services without interruptions.Manual renewals occur when a merchant or a subscriber renew a subscription in the Merchant Portal or Customer Portal manually, usually in the middle of a subscription cycle. The subscription then renews immediately, resetting the billing cycle to start on the manual renewal date.
{"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/subscription-renewal","slug":"/glossary/subscription-renewal","pageMetadata":{"title":"Subscription Renewal","description":null,"href":"/glossary/subscription-renewal"},"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`,strong:`strong`,..._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:`Extending a subscription for another period.`})}),`\n`,_jsx(Heading,{level:`2`,id:`what-is-a-renewal-in-subscription`,children:`What is a renewal in subscription`}),`\n`,_jsxs(_components.p,{children:[`Renewal is an automatic or manual extension of an active `,_jsx(_components.a,{href:`/glossary/subscription`,children:`subscription`}),` that causes a new `,_jsx(_components.a,{href:`/glossary/subscription-order`,children:`subscription order`}),` to be placed. `,_jsx(_components.a,{href:`/glossary/subscription-renewal`,children:`Renewal`}),` marks the beginning of a new subscription cycle and allows to keep the subscription for the length of that cycle (provided it’s not canceled manually before the cycle ends).`]}),`\n`,_jsxs(_components.p,{children:[`Renewals only occur in subscriptions, `,_jsx(_components.a,{href:`/glossary/subscription-box`,children:`subscription boxes`}),`, and `,_jsx(_components.a,{href:`/glossary/membership`,children:`memberships`}),`, which sets them apart from regular, one-time orders.`]}),`\n`,_jsx(Heading,{level:`2`,id:`what-are-two-types-of-subscription-renewals`,children:`What are two types of subscription renewals`}),`\n`,_jsx(_components.p,{children:`There are two types of renewal: automatic and manual.`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Automatic renewals`}),` or auto-renewals allow for a subscription to be automatically renewed at the beginning of each subscription cycle. Thanks to that, a subscription will continue to be active and the `,_jsx(_components.a,{href:`/glossary/subscriber`,children:`subscriber`}),` will keep access to their subscription products or services without interruptions.`]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Manual renewals`}),` occur when a merchant or a subscriber renew a subscription in the `,_jsx(_components.a,{href:`/glossary/merchant-portal`,children:`Merchant Portal`}),` or `,_jsx(_components.a,{href:`/glossary/customer-portal`,children:`Customer Portal`}),` manually, usually in the middle of a subscription cycle. The subscription then renews immediately, resetting the billing cycle to start on the manual renewal date.`]})]})}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":"Subscription Renewal","description":null,"href":"/glossary/subscription-renewal"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"What is a renewal in subscription","slug":"what-is-a-renewal-in-subscription","depth":2,"children":[]},{"title":"What are two types of subscription renewals","slug":"what-are-two-types-of-subscription-renewals","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"juo-docs","siteName":"Juo Subscriptions documentation","title":"Subscription Renewal - Juo Subscriptions documentation","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-30T13:35:53.819Z","originalFileLocation":"glossary/subscription-renewal.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=\"Subscription Renewal - 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/subscription-renewal\">\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=Subscription+Renewal\u0026amp;theme=744beef7a106f2cad03d3b03\u0026amp;signature=4b8eec0f1a720293658040b6ecef4e9e41543e0d95d3afe23ea4a732629153b4\">\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=\"Subscription Renewal - 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=Subscription+Renewal\u0026amp;theme=744beef7a106f2cad03d3b03\u0026amp;signature=4b8eec0f1a720293658040b6ecef4e9e41543e0d95d3afe23ea4a732629153b4\">\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/subscription-renewal\">\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/subscription-renewal.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/subscription-renewal#webpage\",\"url\":\"https://juo.io/docs/glossary/subscription-renewal\",\"name\":\"Subscription Renewal\",\"dateModified\":\"2026-10-30T13:35:53.819Z\",\"isPartOf\":{\"@id\":\"https://juo.io/docs#website\"},\"breadcrumb\":{\"@id\":\"https://juo.io/docs/glossary/subscription-renewal#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://juo.io/docs/glossary/subscription-renewal#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\":\"Subscription Renewal\",\"item\":\"https://juo.io/docs/glossary/subscription-renewal\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://juo.io/docs/glossary/subscription-renewal#article\",\"headline\":\"Subscription Renewal\",\"name\":\"Subscription Renewal\",\"url\":\"https://juo.io/docs/glossary/subscription-renewal\",\"mainEntityOfPage\":{\"@id\":\"https://juo.io/docs/glossary/subscription-renewal#webpage\"},\"dateModified\":\"2026-10-30T13:35:53.819Z\",\"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","href":"/glossary/one-time-purchase"},{"title":"Product Swap","href":"/glossary/product-swap"},{"title":"Retention Flow","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","description":null,"href":"/glossary/subscription-pause"},{"title":"Subscription Renewal","href":"/glossary/subscription-renewal"},{"title":"Subscription","description":null,"href":"/glossary/subscription"},{"title":"Variable Discount","href":"/glossary/variable-discount"}]}]}]},"basePath":"","title":"Subscription Renewal - Juo Subscriptions documentation","buildId":"dpl_CEsowfH15TDzsBT2BFbX312Be4Ct","deploymentId":"dpl_CEsowfH15TDzsBT2BFbX312Be4Ct","dynamics":[],"chunks":[]}