[{"data":1,"prerenderedAt":829},["ShallowReactive",2],{"header:help":3,"footer:default":67,"story:navigation\u002Fsearch:help":250,"story:help\u002Fcategories":288,"story:help\u002Farticles\u002Fupgrade-or-downgrade-a-subscription":314,"no-guide:upgrade-or-downgrade-a-subscription":59,"article:\u002Fhelp\u002Farticles\u002Fupgrade-or-downgrade-a-subscription":538,"story:contact":552,"help:tree:206d9bf3-56f3-4de0-a79f-3e176c8f23a4":742,"_apollo:default":828},{"name":4,"created_at":5,"published_at":6,"updated_at":7,"id":8,"uuid":9,"content":10,"slug":57,"full_slug":58,"sort_by_date":59,"position":60,"tag_list":61,"is_startpage":24,"parent_id":62,"meta_data":59,"group_id":63,"first_published_at":64,"release_id":59,"lang":65,"path":59,"alternates":66,"default_full_slug":59,"translated_slugs":59},"Help Center Header","2024-08-09T18:06:34.939Z","2024-10-21T21:58:39.217Z","2024-10-21T21:58:39.232Z",10082752,"3e9b88f7-c163-4657-a2f2-62532d600fad",{"_uid":11,"link":12,"badge":16,"items":17,"title":13,"buttons":50,"new_tab":24,"submenu":51,"alignment":13,"component":52,"badge_link":53,"top_menu_items":56},"e5645a1a-f991-40e8-8d67-e40ebc082b5a",{"id":13,"url":13,"linktype":14,"fieldtype":15,"cached_url":13},"","story","multilink","Help Center",[18,27,34,39,44],{"_uid":19,"link":20,"title":23,"new_tab":24,"submenu":25,"component":26},"5cbe2861-1f49-4166-97da-a4dddd8105e3",{"id":21,"url":13,"linktype":14,"fieldtype":15,"cached_url":22},"4c0a2d99-ec30-4579-8ef1-6bf5564d4839","help\u002Fcategories\u002F","Articles",false,[],"header___item",{"_uid":28,"link":29,"title":32,"new_tab":33,"component":26},"1c8edeb5-b9e9-4cb8-b1c6-c1f292f7d7cd",{"id":13,"url":30,"linktype":31,"fieldtype":15,"cached_url":30},"https:\u002F\u002Fwiki.foxycart.com\u002F","url","Documentation",true,{"_uid":35,"link":36,"title":38,"new_tab":33,"component":26},"8d7df70e-f087-4da0-b616-6f0e9a5af35c",{"id":13,"url":37,"linktype":31,"fieldtype":15,"cached_url":37},"https:\u002F\u002Fapi.foxycart.com\u002F","API Documentation",{"_uid":40,"link":41,"title":43,"new_tab":33,"component":26},"f76e7944-23d5-4652-87e4-cdae79272762",{"id":13,"url":42,"linktype":31,"fieldtype":15,"cached_url":42},"https:\u002F\u002Fstatus.foxy.io\u002F","System Status",{"_uid":45,"link":46,"title":49,"new_tab":24,"component":26},"0de16771-4c84-466c-a1da-d8568113c71f",{"id":47,"url":13,"linktype":14,"fieldtype":15,"cached_url":48},"01e4e370-f9b9-45af-8fa9-f15540699b0d","contact","Contact Us",[],[],"header",{"id":54,"url":13,"linktype":14,"fieldtype":15,"cached_url":55},"4a679eb7-662d-4ea4-a976-5a2acbf0b663","help\u002F",[],"help-header","navigation\u002Fhelp-header",null,20,[],10082747,"71b81c2e-5e09-48a1-a397-a3c72fcd344a","2022-09-21T14:50:25.655Z","default",[],{"name":68,"created_at":69,"published_at":70,"updated_at":71,"id":72,"uuid":73,"content":74,"slug":243,"full_slug":244,"sort_by_date":59,"position":245,"tag_list":246,"is_startpage":24,"parent_id":62,"meta_data":59,"group_id":247,"first_published_at":248,"release_id":59,"lang":65,"path":59,"alternates":249,"default_full_slug":59,"translated_slugs":59},"Default Footer","2024-08-09T18:06:59.024Z","2025-09-04T06:24:46.223Z","2025-09-04T06:24:46.241Z",10082753,"e59e67ac-248a-482f-84a1-53d4f318186a",{"_uid":75,"about":76,"logos":77,"socials":82,"sections":108,"component":225,"cta_title":226,"bottom_links":227,"cta_subtitle":241,"cta_button_link":242,"cta_button_text":183},"830983f5-c4c4-43c8-b150-86a5e3fa6dc8","Foxy’s hosted cart & payment page allow you to sell anything, using your existing website or platform.",[78],{"id":79,"alt":13,"name":13,"focus":13,"title":13,"filename":80,"copyright":13,"fieldtype":81},14760,"https:\u002F\u002Fa-us.storyblok.com\u002Ff\u002F1001040\u002Fx\u002F3b030847ec\u002Fb-corp.svg","asset",[83,90,96,102],{"_uid":84,"icon":85,"link":86,"name":88,"component":89},"faf0a618-ea94-42ea-9182-03be18c43216","fa-facebook",{"id":13,"url":87,"linktype":31,"fieldtype":15,"cached_url":87},"https:\u002F\u002Fwww.facebook.com\u002Ffoxycart","Facebook","footer___social",{"_uid":91,"icon":92,"link":93,"name":95,"component":89},"14309c18-7e79-423e-b375-34555bac0811","fa-instagram",{"id":13,"url":94,"linktype":31,"fieldtype":15,"cached_url":94},"https:\u002F\u002Fwww.instagram.com\u002Ffoxy_io","Instagram",{"_uid":97,"icon":98,"link":99,"name":101,"component":89},"8f7fe7cf-0dd3-4596-8334-226ea466716a","fa-linkedin",{"id":13,"url":100,"linktype":31,"fieldtype":15,"cached_url":100},"https:\u002F\u002Fwww.linkedin.com\u002Fcompany\u002Ffoxycart.com","LinkedIn",{"_uid":103,"icon":104,"link":105,"name":107,"component":89},"90a675b4-dd97-40b5-be09-00a87223d4c5","fa-youtube",{"id":13,"url":106,"linktype":31,"fieldtype":15,"cached_url":106},"https:\u002F\u002Fwww.youtube.com\u002Fuser\u002Ffoxycart","Youtube",[109,139,184,206],{"_uid":110,"name":111,"items":112,"component":138},"82849945-282f-488c-b18d-a8d2252f514a","Company",[113,120,126,132],{"_uid":114,"link":115,"title":118,"new_tab":24,"component":119},"1f699ab1-938b-4d9d-9825-aabcbe6f57fe",{"id":116,"url":13,"linktype":14,"fieldtype":15,"cached_url":117},"63634293-a749-4226-9439-9f38ee6dcda0","about-us","About Us","footer___menu_items",{"_uid":121,"link":122,"title":125,"new_tab":24,"component":119},"b26b00f1-a0e7-4be2-8ab3-428b8cc841f8",{"id":123,"url":13,"linktype":14,"fieldtype":15,"cached_url":124},"26cb7c55-faed-4a77-a291-1552d4111b3e","how-foxy-works","How Foxy Works",{"_uid":127,"link":128,"title":131,"new_tab":24,"component":119},"b40c68a0-1ceb-4226-9515-6176534f61fe",{"id":129,"url":13,"linktype":14,"fieldtype":15,"cached_url":130},"dc6657d7-7f4f-4c0d-b781-e971b038ee26","for-good","Foxy For Good",{"_uid":133,"link":134,"title":137,"new_tab":24,"component":119},"3ad0c134-bef9-4fff-b891-e09f16109036",{"id":135,"url":13,"linktype":14,"fieldtype":15,"cached_url":136},"23cae210-baf4-4588-9862-d09f4f52ccd2","brand-assets","Brand Assets","footer___section",{"_uid":140,"name":141,"items":142,"component":138},"a6805fa8-ac60-47f1-b8f0-f27aded0afbe","Product",[143,149,155,161,167,173,179],{"_uid":144,"link":145,"title":148,"new_tab":24,"component":119},"b39c8a4e-2383-486f-b76a-11fbb15d8134",{"id":146,"url":13,"linktype":14,"fieldtype":15,"cached_url":147},"bb04690f-fe98-4ce6-80be-05b950f2364f","features\u002F","Features",{"_uid":150,"link":151,"title":154,"new_tab":24,"component":119},"64f8a41f-c181-433d-bc0a-fc94e71ecbf6",{"id":152,"url":13,"linktype":14,"fieldtype":15,"cached_url":153},"c450c58d-761d-48c0-a9af-0b064611689b","pricing","Pricing",{"_uid":156,"link":157,"title":160,"new_tab":24,"component":119},"6e0b287f-fd8c-4146-9e0e-0ab0b5c9ce3c",{"id":158,"url":13,"linktype":14,"fieldtype":15,"cached_url":159},"fab20ad9-e76a-4947-b709-3a6fdfa88028","blog\u002Fcategories\u002Fproduct-updates","Product Updates",{"_uid":162,"link":163,"title":166,"new_tab":24,"component":119},"47e5a074-a6b5-4f1c-8c2f-89a2ae9f83eb",{"id":164,"url":13,"linktype":14,"fieldtype":15,"cached_url":165},"d2c83612-d611-47f3-a3b4-ca7fe08540b8","changelogs\u002F","Changelogs",{"_uid":168,"link":169,"title":172,"new_tab":24,"component":119},"b5c08774-542f-4ffd-b357-c94d674488b9",{"id":170,"url":13,"linktype":14,"fieldtype":15,"cached_url":171},"08876121-0df3-4ed9-aa11-902b3e41cd02","whats-next","What's Next",{"_uid":174,"link":175,"title":178,"new_tab":24,"component":119},"9c2704ed-6d9f-43e1-9e67-c8d91c083288",{"id":176,"url":13,"linktype":14,"fieldtype":15,"cached_url":177},"056a7857-b18f-4025-8f97-91a38fc19bc8","compare\u002F","Compare",{"_uid":180,"link":181,"title":183,"new_tab":24,"component":119},"5f2db35b-674b-406a-8fa7-d246633af9fe",{"id":13,"url":182,"linktype":31,"fieldtype":15,"cached_url":182},"https:\u002F\u002Fadmin.foxy.io\u002Fsign-up","Try Foxy Free",{"_uid":185,"name":186,"items":187,"component":138},"63fa1f29-4252-4640-9922-fe310e69e54a","Security",[188,194,200],{"_uid":189,"link":190,"title":193,"new_tab":24,"component":119},"1158ddb6-9eb0-466f-8eb6-7ca2ae66c8b8",{"id":191,"url":13,"linktype":14,"fieldtype":15,"cached_url":192},"1f58fb2c-8681-4742-b6e8-09999beae9f6","security-contact","Security Contact",{"_uid":195,"link":196,"title":199,"new_tab":24,"component":119},"9a79c54a-6022-4dfd-854b-766f5e4703ba",{"id":197,"url":13,"linktype":14,"fieldtype":15,"cached_url":198},"55cbfcc3-425a-4261-8037-54e919851d2d","pci","PCI Compliance",{"_uid":201,"link":202,"title":205,"new_tab":24,"component":119},"0b85f5b6-9534-4071-b323-b39d053dd4d7",{"id":203,"url":13,"linktype":14,"fieldtype":15,"cached_url":204},"c3ac0fe3-83e2-4879-afbd-d4c83e1590df","help\u002Farticles\u002Four-official-domains-public-code","Domains & Codebases",{"_uid":207,"name":208,"items":209,"component":138},"998ded67-d107-49f4-8154-ca6be51671ec","Support",[210,213,216,219,222],{"_uid":211,"link":212,"title":16,"new_tab":24,"component":119},"594ffd35-3049-4004-bb08-0db568ebd819",{"id":54,"url":13,"linktype":14,"fieldtype":15,"cached_url":55},{"_uid":214,"link":215,"title":32,"new_tab":33,"component":119},"0a1a55ab-a985-4f9d-8b42-26da714d0c1c",{"id":13,"url":30,"linktype":31,"fieldtype":15,"cached_url":30},{"_uid":217,"link":218,"title":38,"new_tab":33,"component":119},"61e0b7c8-aadf-419b-a339-b3ccabc65bf4",{"id":13,"url":37,"linktype":31,"fieldtype":15,"cached_url":37},{"_uid":220,"link":221,"title":43,"new_tab":33,"component":119},"fd67a89e-1c54-4d31-94b5-64be999062d6",{"id":13,"url":42,"linktype":31,"fieldtype":15,"cached_url":42},{"_uid":223,"link":224,"title":49,"new_tab":24,"component":119},"231a6f71-e996-4ad4-b033-d4d5542f34f0",{"id":47,"url":13,"linktype":14,"fieldtype":15,"cached_url":48},"footer","Get started with our *unlimited free trial*.",[228,235],{"_uid":229,"link":230,"text":233,"component":234},"f0b77210-2632-45a2-8436-e57cad84d01a",{"id":231,"url":13,"linktype":14,"fieldtype":15,"cached_url":232},"60ba16a2-c1f4-485f-b978-8d2eeeafbf5a","terms-of-service","Terms of Service","footer___bottom_links",{"_uid":236,"link":237,"text":240,"component":234},"4bd497b0-993f-4b4d-a5b7-8a49c7c8fec9",{"id":238,"url":13,"linktype":14,"fieldtype":15,"cached_url":239},"332302b9-1d18-4016-b9c8-9b33c72d782b","privacy-policy","Privacy Policy","No credit card required.",{"id":13,"url":182,"linktype":31,"fieldtype":15,"cached_url":182},"default-footer","navigation\u002Fdefault-footer",50,[],"11006268-07f9-41e9-96f3-c51fb723399d","2022-09-21T20:39:02.357Z",[],{"name":251,"created_at":252,"published_at":253,"updated_at":254,"id":255,"uuid":256,"content":257,"slug":279,"full_slug":282,"sort_by_date":59,"position":283,"tag_list":284,"is_startpage":24,"parent_id":62,"meta_data":59,"group_id":285,"first_published_at":286,"release_id":59,"lang":65,"path":59,"alternates":287,"default_full_slug":59,"translated_slugs":59},"Search","2024-10-21T22:08:54.973Z","2025-05-26T09:17:25.790Z","2025-05-26T09:17:25.804Z",13592003,"14cbc359-9ac1-4a7a-a8de-ad4ac8ef26d4",{"_uid":258,"name":251,"indices":259,"summary":13,"component":279,"primary_image":280},"5e4a56e8-76f1-4790-b3a7-70f1be97d042",[260,265,269,274],{"key":261,"_uid":262,"icon":13,"name":263,"component":264},"all","c12a3210-7323-4273-8217-5215e52efe84","All","index",{"key":266,"_uid":267,"icon":268,"name":23,"component":264},"help_center_article","5acff080-95e4-44d3-8dcf-1b19720af382","fa-file-alt",{"key":270,"_uid":271,"icon":272,"name":273,"component":264},"help_center_guide","b8fbc206-c083-471e-a1f0-0ebeb90a669d","fa-book","Guides",{"key":275,"_uid":276,"icon":277,"name":278,"component":264},"blog_post","23419e83-2e56-4c4c-8a05-9fd1b3c9a9bd","fa-file-image","Blog Posts","search",{"id":59,"alt":59,"name":13,"focus":59,"title":59,"source":59,"filename":13,"copyright":59,"fieldtype":81,"meta_data":281},{},"navigation\u002Fsearch",60,[],"11e1fd31-95cd-4fc9-b736-8b8910663e6c","2024-10-21T23:17:05.904Z",[],{"name":23,"created_at":289,"published_at":290,"updated_at":291,"id":292,"uuid":21,"content":293,"slug":307,"full_slug":22,"sort_by_date":59,"position":308,"tag_list":309,"is_startpage":33,"parent_id":310,"meta_data":59,"group_id":311,"first_published_at":312,"release_id":59,"lang":65,"path":59,"alternates":313,"default_full_slug":59,"translated_slugs":59},"2022-09-19T14:42:29.685Z","2024-07-30T18:17:22.506Z","2024-07-30T18:17:22.525Z",2660,{"_uid":294,"icon":13,"name":23,"guides":295,"pinned":24,"summary":296,"category":13,"component":297,"blog_posts":298,"content_hub":24,"icon_custom":299,"case_studies":300,"faq_sections":301,"help_articles":302,"featured_guides":303,"mailbox_category":13,"featured_articles":304,"featured_blog_posts":305,"featured_case_studies":306},"d6dae89a-907a-4bf7-82de-fe2ba875ee6e",[],"Get your questions answered with our browsable knowledge base.","help_center_category",[],{"id":59,"alt":59,"name":13,"focus":59,"title":59,"filename":13,"copyright":59,"fieldtype":81},[],[],[],[],[],[],[],"categories",530,[],2658,"19ebcdd2-027f-47f5-9a5b-a8992c959578","2022-09-19T16:24:39.219Z",[],{"name":315,"created_at":316,"published_at":317,"updated_at":318,"id":319,"uuid":320,"content":321,"slug":531,"full_slug":532,"sort_by_date":59,"position":533,"tag_list":534,"is_startpage":24,"parent_id":535,"meta_data":59,"group_id":536,"first_published_at":317,"release_id":59,"lang":65,"path":59,"alternates":537,"default_full_slug":59,"translated_slugs":59},"Upgrade or downgrade a subscription","2026-06-10T20:15:02.104Z","2026-06-10T20:22:19.404Z","2026-06-10T20:22:19.417Z",186093167064986,"206d9bf3-56f3-4de0-a79f-3e176c8f23a4",{"_uid":322,"body":323,"name":315,"image":526,"pinned":24,"summary":528,"category":529,"component":266,"related_articles":530},"bcbf86a4-b510-4527-afba-6246caa0c6d5",{"type":324,"content":325},"doc",[326,346,361,368,421,426,432,437,442,452,466,471],{"type":327,"attrs":328,"content":329},"paragraph",{"textAlign":59},[330,333,338,340,344],{"text":331,"type":332},"To upgrade or downgrade a customer’s subscription, use the ","text",{"text":334,"type":332,"marks":335},"sub_modify=replace",[336],{"type":337},"code",{"text":339,"type":332}," parameter combined with a ",{"text":341,"type":332,"marks":342},"sub_token",[343],{"type":337},{"text":345,"type":332}," to completely replace the existing subscription’s products with new ones.",{"type":327,"attrs":347,"content":348},{"textAlign":59},[349,351,354,356,359],{"text":350,"type":332},"By default, loading a ",{"text":341,"type":332,"marks":352},[353],{"type":337},{"text":355,"type":332}," into the cart appends products to the existing subscription. Adding ",{"text":334,"type":332,"marks":357},[358],{"type":337},{"text":360,"type":332}," changes this behaviour so the existing products are replaced entirely.",{"type":362,"attrs":363,"content":365},"heading",{"level":364,"textAlign":59},2,[366],{"text":367,"type":332},"How to set it up",{"type":369,"attrs":370,"content":372},"ordered_list",{"order":371},1,[373,386],{"type":374,"content":375},"list_item",[376],{"type":327,"attrs":377,"content":378},{"textAlign":59},[379,381,384],{"text":380,"type":332},"Retrieve the customer’s ",{"text":341,"type":332,"marks":382},[383],{"type":337},{"text":385,"type":332}," from the Foxy admin, API, or Subscription XML Datafeed.",{"type":374,"content":387},[388,393],{"type":327,"attrs":389,"content":390},{"textAlign":59},[391],{"text":392,"type":332},"Build an add-to-cart link or form for the new subscription plan that includes:",{"type":394,"content":395},"bullet_list",[396,403,413],{"type":374,"content":397},[398],{"type":327,"attrs":399,"content":400},{"textAlign":59},[401],{"text":402,"type":332},"The new product(s) and pricing",{"type":374,"content":404},[405],{"type":327,"attrs":406,"content":407},{"textAlign":59},[408,411],{"text":341,"type":332,"marks":409},[410],{"type":337},{"text":412,"type":332}," set to the customer’s token",{"type":374,"content":414},[415],{"type":327,"attrs":416,"content":417},{"textAlign":59},[418],{"text":334,"type":332,"marks":419},[420],{"type":337},{"type":327,"attrs":422,"content":423},{"textAlign":59},[424],{"text":425,"type":332},"For example:",{"type":427,"attrs":428,"content":429},"code_block",{"class":59},[430],{"text":431,"type":332},"https:\u002F\u002FYOURSTORE.foxycart.com\u002Fcart?\n  name=Premium+plan&price=40&sub_frequency=1m\n  &sub_token=TOKEN&sub_modify=replace",{"type":327,"attrs":433,"content":434},{"textAlign":59},[435],{"text":436,"type":332},"When the customer completes checkout, their existing subscription products are replaced with the new ones.",{"type":362,"attrs":438,"content":439},{"level":364,"textAlign":59},[440],{"text":441,"type":332},"Use cases",{"type":327,"attrs":443,"content":444},{"textAlign":59},[445,450],{"text":446,"type":332,"marks":447},"Plan upgrades and downgrades:",[448],{"type":449},"bold",{"text":451,"type":332}," Build upgrade and downgrade links for each plan combination. When a customer clicks the link and checks out, their subscription is updated to the new plan.",{"type":327,"attrs":453,"content":454},{"textAlign":59},[455,459,461,464],{"text":456,"type":332,"marks":457},"Auto-ship subscription changes:",[458],{"type":449},{"text":460,"type":332}," If a customer has a subscription containing multiple products and wants to change the product mix entirely, use ",{"text":334,"type":332,"marks":462},[463],{"type":337},{"text":465,"type":332}," to swap out the full set of products in one transaction.",{"type":362,"attrs":467,"content":468},{"level":364,"textAlign":59},[469],{"text":470,"type":332},"Notes",{"type":394,"content":472},[473,483,496,514],{"type":374,"content":474},[475],{"type":327,"attrs":476,"content":477},{"textAlign":59},[478,481],{"text":334,"type":332,"marks":479},[480],{"type":337},{"text":482,"type":332}," does not prorate the subscription. If the customer is mid-period, any price difference between the old and new subscription is not adjusted.",{"type":374,"content":484},[485],{"type":327,"attrs":486,"content":487},{"textAlign":59},[488,490,494],{"text":489,"type":332},"To remove an end date from the subscription when replacing it, include ",{"text":491,"type":332,"marks":492},"sub_enddate=00000000",[493],{"type":337},{"text":495,"type":332}," in the link.",{"type":374,"content":497},[498],{"type":327,"attrs":499,"content":500},{"textAlign":59},[501,503,506,508,512],{"text":502,"type":332},"Any new subscription products added via a ",{"text":341,"type":332,"marks":504},[505],{"type":337},{"text":507,"type":332}," will automatically have their ",{"text":509,"type":332,"marks":510},"sub_startdate",[511],{"type":337},{"text":513,"type":332}," set to the next scheduled date for that subscription, preventing the customer from being charged again for the current period.",{"type":374,"content":515},[516],{"type":327,"attrs":517,"content":518},{"textAlign":59},[519,521,524],{"text":520,"type":332},"PayPal Express (non-Reference Transactions) does not support subscription modification via ",{"text":341,"type":332,"marks":522},[523],{"type":337},{"text":525,"type":332},". Foxy strongly recommends using the Reference Transaction option for PayPal Express Checkout.",{"id":59,"alt":59,"name":13,"focus":59,"title":59,"source":59,"filename":13,"copyright":59,"fieldtype":81,"meta_data":527},{},"How to replace the products in an existing subscription using sub_modify=replace, for use cases like plan changes and auto-ship updates.","4bbad619-ca8e-4557-b780-5e309a660036",[],"upgrade-or-downgrade-a-subscription","help\u002Farticles\u002Fupgrade-or-downgrade-a-subscription",-2130,[],2659,"ff7ad545-b2af-4d88-ab1e-f29744ef8d53",[],{"html":539,"sections":540,"segments":548},"\u003Cp>To upgrade or downgrade a customer’s subscription, use the \u003Ccode class=\"badge bg-soft-danger text-danger\">sub_modify=replace\u003C\u002Fcode> parameter combined with a \u003Ccode class=\"badge bg-soft-danger text-danger\">sub_token\u003C\u002Fcode> to completely replace the existing subscription’s products with new ones.\u003C\u002Fp>\u003Cp>By default, loading a \u003Ccode class=\"badge bg-soft-danger text-danger\">sub_token\u003C\u002Fcode> into the cart appends products to the existing subscription. Adding \u003Ccode class=\"badge bg-soft-danger text-danger\">sub_modify=replace\u003C\u002Fcode> changes this behaviour so the existing products are replaced entirely.\u003C\u002Fp>\u003Csection id=\"how-to-set-it-up\" data-title=\"How to set it up\" data-title-node=\"H2\">\u003Chr class=\"my-8\" style=\"margin-left: -48px; margin-right: -40vw\">\u003Ch2 data-anchor-id=\"how-to-set-it-up\">How to set it up\u003C\u002Fh2>\u003Col class=\"step step-icon-sm step-dashed step-border-last-0 mt-3\">\u003Cli class=\"step-item\">\u003Cdiv class=\"step-content-wrapper\">\u003Cspan class=\"step-icon step-icon-soft-primary\">1\u003C\u002Fspan>\u003Cdiv class=\"w-100 overflow-hidden\">\u003Cdiv class=\"step-content mt-2\">\u003Cp>Retrieve the customer’s \u003Ccode class=\"badge bg-soft-danger text-danger\">sub_token\u003C\u002Fcode> from the Foxy admin, API, or Subscription XML Datafeed.\u003C\u002Fp>\u003C\u002Fdiv>\u003C\u002Fdiv>\u003C\u002Fdiv>\u003C\u002Fli>\u003Cli class=\"step-item\">\u003Cdiv class=\"step-content-wrapper\">\u003Cspan class=\"step-icon step-icon-soft-primary\">2\u003C\u002Fspan>\u003Cdiv class=\"w-100 overflow-hidden\">\u003Cdiv class=\"step-content mt-2\">\u003Cp>Build an add-to-cart link or form for the new subscription plan that includes:\u003C\u002Fp>\u003Cul>\u003Cli>\u003Cp>The new product(s) and pricing\u003C\u002Fp>\u003C\u002Fli>\u003Cli>\u003Cp>\u003Ccode class=\"badge bg-soft-danger text-danger\">sub_token\u003C\u002Fcode> set to the customer’s token\u003C\u002Fp>\u003C\u002Fli>\u003Cli>\u003Cp>\u003Ccode class=\"badge bg-soft-danger text-danger\">sub_modify=replace\u003C\u002Fcode>\u003C\u002Fp>\u003C\u002Fli>\u003C\u002Ful>\u003C\u002Fdiv>\u003C\u002Fdiv>\u003C\u002Fdiv>\u003C\u002Fli>\u003C\u002Fol>\u003Cp>For example:\u003C\u002Fp>\u003Cdiv class=\"position-relative w-100 overflow-hidden rounded-2\" data-code-block>\u003Cdiv class=\"d-flex justify-content-end border-bottom\" style=\"background:#2b2c3b;\">\u003Cbutton type=\"button\" class=\"btn btn-link btn-sm text-light\" title=\"Copy\" data-code-button>\u003Cspan data-code-default style=\"\">\u003Ci class=\"fal fa-copy me-2\">\u003C\u002Fi> Copy \u003C\u002Fspan>\u003Cspan class=\"text-success\" data-code-success style=\"display:none;\">\u003Ci class=\"fal fa-check ms-2\">\u003C\u002Fi> Copied \u003C\u002Fspan>\u003C\u002Fbutton>\u003C\u002Fdiv>\u003Cdiv class=\"small\">\u003Cpre class=\"hljs p-2\" data-code-content>https:\u002F\u002FYOURSTORE.foxycart.com\u002Fcart?\n  name=Premium+plan&price=40&sub_frequency=1m\n  &sub_token=TOKEN&sub_modify=replace\u003C\u002Fpre>\u003C\u002Fdiv>\u003C\u002Fdiv>\u003Cp>When the customer completes checkout, their existing subscription products are replaced with the new ones.\u003C\u002Fp>\u003C\u002Fsection>\u003Csection id=\"use-cases\" data-title=\"Use cases\" data-title-node=\"H2\">\u003Chr class=\"my-8\" style=\"margin-left: -48px; margin-right: -40vw\">\u003Ch2 data-anchor-id=\"use-cases\">Use cases\u003C\u002Fh2>\u003Cp>\u003Cstrong>Plan upgrades and downgrades:\u003C\u002Fstrong> Build upgrade and downgrade links for each plan combination. When a customer clicks the link and checks out, their subscription is updated to the new plan.\u003C\u002Fp>\u003Cp>\u003Cstrong>Auto-ship subscription changes:\u003C\u002Fstrong> If a customer has a subscription containing multiple products and wants to change the product mix entirely, use \u003Ccode class=\"badge bg-soft-danger text-danger\">sub_modify=replace\u003C\u002Fcode> to swap out the full set of products in one transaction.\u003C\u002Fp>\u003C\u002Fsection>\u003Csection id=\"notes\" data-title=\"Notes\" data-title-node=\"H2\">\u003Chr class=\"my-8\" style=\"margin-left: -48px; margin-right: -40vw\">\u003Ch2 data-anchor-id=\"notes\">Notes\u003C\u002Fh2>\u003Cul>\u003Cli>\u003Cp>\u003Ccode class=\"badge bg-soft-danger text-danger\">sub_modify=replace\u003C\u002Fcode> does not prorate the subscription. If the customer is mid-period, any price difference between the old and new subscription is not adjusted.\u003C\u002Fp>\u003C\u002Fli>\u003Cli>\u003Cp>To remove an end date from the subscription when replacing it, include \u003Ccode class=\"badge bg-soft-danger text-danger\">sub_enddate=00000000\u003C\u002Fcode> in the link.\u003C\u002Fp>\u003C\u002Fli>\u003Cli>\u003Cp>Any new subscription products added via a \u003Ccode class=\"badge bg-soft-danger text-danger\">sub_token\u003C\u002Fcode> will automatically have their \u003Ccode class=\"badge bg-soft-danger text-danger\">sub_startdate\u003C\u002Fcode> set to the next scheduled date for that subscription, preventing the customer from being charged again for the current period.\u003C\u002Fp>\u003C\u002Fli>\u003Cli>\u003Cp>PayPal Express (non-Reference Transactions) does not support subscription modification via \u003Ccode class=\"badge bg-soft-danger text-danger\">sub_token\u003C\u002Fcode>. Foxy strongly recommends using the Reference Transaction option for PayPal Express Checkout.\u003C\u002Fp>\u003C\u002Fli>\u003C\u002Ful>\u003C\u002Fsection>",[541,544,546],{"id":542,"title":367,"level":543},"how-to-set-it-up","H2",{"id":545,"title":441,"level":543},"use-cases",{"id":547,"title":470,"level":543},"notes",[549],{"type":550,"content":551},"html","\u003Cp>To upgrade or downgrade a customer’s subscription, use the \u003Ccode class=\"badge bg-soft-danger text-danger\">sub_modify=replace\u003C\u002Fcode> parameter combined with a \u003Ccode class=\"badge bg-soft-danger text-danger\">sub_token\u003C\u002Fcode> to completely replace the existing subscription’s products with new ones.\u003C\u002Fp>\u003Cp>By default, loading a \u003Ccode class=\"badge bg-soft-danger text-danger\">sub_token\u003C\u002Fcode> into the cart appends products to the existing subscription. Adding \u003Ccode class=\"badge bg-soft-danger text-danger\">sub_modify=replace\u003C\u002Fcode> changes this behaviour so the existing products are replaced entirely.\u003C\u002Fp>\u003Ch2>How to set it up\u003C\u002Fh2>\u003Col order=\"1\">\u003Cli>\u003Cp>Retrieve the customer’s \u003Ccode class=\"badge bg-soft-danger text-danger\">sub_token\u003C\u002Fcode> from the Foxy admin, API, or Subscription XML Datafeed.\u003C\u002Fp>\u003C\u002Fli>\u003Cli>\u003Cp>Build an add-to-cart link or form for the new subscription plan that includes:\u003C\u002Fp>\u003Cul>\u003Cli>\u003Cp>The new product(s) and pricing\u003C\u002Fp>\u003C\u002Fli>\u003Cli>\u003Cp>\u003Ccode class=\"badge bg-soft-danger text-danger\">sub_token\u003C\u002Fcode> set to the customer’s token\u003C\u002Fp>\u003C\u002Fli>\u003Cli>\u003Cp>\u003Ccode class=\"badge bg-soft-danger text-danger\">sub_modify=replace\u003C\u002Fcode>\u003C\u002Fp>\u003C\u002Fli>\u003C\u002Ful>\u003C\u002Fli>\u003C\u002Fol>\u003Cp>For example:\u003C\u002Fp>\u003Cpre>\u003Ccode>https:\u002F\u002FYOURSTORE.foxycart.com\u002Fcart?\n  name=Premium+plan&price=40&sub_frequency=1m\n  &sub_token=TOKEN&sub_modify=replace\u003C\u002Fcode>\u003C\u002Fpre>\u003Cp>When the customer completes checkout, their existing subscription products are replaced with the new ones.\u003C\u002Fp>\u003Ch2>Use cases\u003C\u002Fh2>\u003Cp>\u003Cstrong>Plan upgrades and downgrades:\u003C\u002Fstrong> Build upgrade and downgrade links for each plan combination. When a customer clicks the link and checks out, their subscription is updated to the new plan.\u003C\u002Fp>\u003Cp>\u003Cstrong>Auto-ship subscription changes:\u003C\u002Fstrong> If a customer has a subscription containing multiple products and wants to change the product mix entirely, use \u003Ccode class=\"badge bg-soft-danger text-danger\">sub_modify=replace\u003C\u002Fcode> to swap out the full set of products in one transaction.\u003C\u002Fp>\u003Ch2>Notes\u003C\u002Fh2>\u003Cul>\u003Cli>\u003Cp>\u003Ccode class=\"badge bg-soft-danger text-danger\">sub_modify=replace\u003C\u002Fcode> does not prorate the subscription. If the customer is mid-period, any price difference between the old and new subscription is not adjusted.\u003C\u002Fp>\u003C\u002Fli>\u003Cli>\u003Cp>To remove an end date from the subscription when replacing it, include \u003Ccode class=\"badge bg-soft-danger text-danger\">sub_enddate=00000000\u003C\u002Fcode> in the link.\u003C\u002Fp>\u003C\u002Fli>\u003Cli>\u003Cp>Any new subscription products added via a \u003Ccode class=\"badge bg-soft-danger text-danger\">sub_token\u003C\u002Fcode> will automatically have their \u003Ccode class=\"badge bg-soft-danger text-danger\">sub_startdate\u003C\u002Fcode> set to the next scheduled date for that subscription, preventing the customer from being charged again for the current period.\u003C\u002Fp>\u003C\u002Fli>\u003Cli>\u003Cp>PayPal Express (non-Reference Transactions) does not support subscription modification via \u003Ccode class=\"badge bg-soft-danger text-danger\">sub_token\u003C\u002Fcode>. Foxy strongly recommends using the Reference Transaction option for PayPal Express Checkout.\u003C\u002Fp>\u003C\u002Fli>\u003C\u002Ful>",{"name":553,"created_at":554,"published_at":555,"updated_at":556,"id":557,"uuid":47,"content":558,"slug":48,"full_slug":48,"sort_by_date":59,"position":737,"tag_list":738,"is_startpage":24,"parent_id":59,"meta_data":59,"group_id":739,"first_published_at":740,"release_id":59,"lang":65,"path":59,"alternates":741,"default_full_slug":59,"translated_slugs":59},"Contact","2022-09-23T19:56:58.957Z","2025-05-08T18:24:40.382Z","2025-05-08T18:24:40.392Z",3138,{"seo":559,"_uid":562,"title":563,"action":564,"fields":565,"method":713,"columns":714,"subtitle":728,"component":48,"button_text":734,"submit_title":735,"submit_subtitle":736},{"_uid":560,"title":553,"plugin":561,"description":13},"24ff7574-3bcc-48d2-85b5-e529dfea1cc4","meta-fields","8f54f1da-9d8f-49b2-89e7-840e886491cb","We're here to help.","https:\u002F\u002Fusebasin.com\u002Ff\u002F029f48d65402",[566,571,575,684,687,692,707],{"_uid":567,"name":568,"type":332,"label":569,"options":13,"required":33,"component":570,"placeholder":13},"9a70b226-2036-4f90-a052-b3efa61c5896","name","Name","form___field",{"_uid":572,"name":573,"type":573,"label":574,"options":13,"required":33,"component":570,"placeholder":13},"86ba35be-ff43-4a28-8633-14052a8f6622","email","Email Address",{"_uid":576,"name":577,"type":578,"label":579,"options":580,"required":33,"component":570,"conditions":581,"placeholder":13},"3f827475-492c-4f97-aa1e-2386ac263b6c","topic","select","Topic","Presales, Support, Billing, Partnerships, Order Enquiry, Other",[582,638,648,655,663,671,677],{"_uid":583,"equals":584,"fields":585,"component":637},"e21d97dd-e68e-4fa6-ba97-bc40f3041dde","Order Enquiry",[586],{"_uid":587,"body":588,"type":635,"title":13,"component":636},"b64992bc-6d53-48b8-b7a0-d81e5a062e50",{"type":324,"content":589},[590],{"type":327,"content":591},[592,594,602,604,606,607,611,613,618,626,628,633],{"text":593,"type":332},"We are ",{"text":595,"type":332,"marks":596},"Foxy.io",[597],{"type":598,"attrs":599},"link",{"href":600,"uuid":59,"anchor":59,"custom":601,"target":59,"linktype":31},"http:\u002F\u002FFoxy.io",{},{"text":603,"type":332},", an ecommerce platform powering ecommerce for other merchants. We do not sell products, and are unable to assist with questions about order statuses or refunds for any merchants using our platform. Please contact the merchant you ordered from for assistance. If you’d like to report a store using Foxy for fraudulent practices, please select ‘other’ in the subject.",{"type":605},"hard_break",{"type":605},{"text":608,"type":332,"marks":609},"NOTE:",[610],{"type":449},{"text":612,"type":332}," We are ",{"text":614,"type":332,"marks":615},"not ",[616],{"type":617},"italic",{"text":619,"type":332,"marks":620},"Foxy.in",[621,625],{"type":598,"attrs":622},{"href":623,"uuid":59,"anchor":59,"custom":624,"target":59,"linktype":31},"http:\u002F\u002FFoxy.in",{},{"type":617},{"text":627,"type":332},". We are not in any way affiliated with ",{"text":619,"type":332,"marks":629},[630],{"type":598,"attrs":631},{"href":623,"uuid":59,"anchor":59,"custom":632,"target":59,"linktype":31},{},{"text":634,"type":332},", and cannot help in any way with your order from that website.","danger","global___alert","form___condition",{"_uid":639,"equals":640,"fields":641,"component":637},"8765c3e1-25cf-44aa-b8ea-fc6094acf9c3","Presales",[642],{"_uid":643,"name":644,"type":645,"label":13,"options":13,"required":24,"component":570,"conditions":646,"placeholder":13,"default_value":647},"cf464f8e-d643-4f6e-af29-d3abffaf7380","department_email_address","hidden",[],"hello@foxy.io",{"_uid":649,"equals":208,"fields":650,"component":637},"4007b6d8-77e5-421d-bd1e-6f336dd853fb",[651],{"_uid":652,"name":644,"type":645,"label":13,"options":13,"required":24,"component":570,"conditions":653,"placeholder":13,"default_value":654},"7b4c6aa5-a68c-45e0-9ce1-0a36af10c0c2",[],"help@foxy.io",{"_uid":656,"equals":657,"fields":658,"component":637},"1dbb8f11-613d-43cd-9e09-1b94f6e19219","Billing",[659],{"_uid":660,"name":644,"type":645,"label":13,"options":13,"required":24,"component":570,"conditions":661,"placeholder":13,"default_value":662},"a0ac0d1b-bc4f-4a6c-a682-581d450b0b73",[],"help+billing@foxy.io",{"_uid":664,"equals":665,"fields":666,"component":637},"a0a53a50-7172-4a29-ba58-181e38874e12","Partnerships",[667],{"_uid":668,"name":644,"type":645,"label":13,"options":13,"required":24,"component":570,"conditions":669,"placeholder":13,"default_value":670},"7aa011d9-f374-4aed-b5a5-929b54aaf152",[],"partners@foxy.io",{"_uid":672,"equals":584,"fields":673,"component":637},"a4cd431f-25d5-41c7-bfdc-02c908c8fb47",[674],{"_uid":675,"name":644,"type":645,"label":13,"options":13,"required":24,"component":570,"conditions":676,"placeholder":13,"default_value":647},"f5d52168-d6ae-451b-94ee-2ced1cbd28ad",[],{"_uid":678,"equals":679,"fields":680,"component":637},"25aba1ed-eb41-4bbc-aa89-f7a7167ea86e","Other",[681],{"_uid":682,"name":644,"type":645,"label":13,"options":13,"required":24,"component":570,"conditions":683,"placeholder":13,"default_value":647},"f40dfaef-c203-4b71-bf4e-e1b43cef192b",[],{"_uid":685,"component":686},"e9c53a05-f40a-4510-aaf8-bc072a235a0c","form___subject",{"_uid":688,"name":689,"type":690,"label":691,"options":13,"required":33,"component":570,"placeholder":13},"a4c4d385-fff4-4978-99fb-b68cfea623d6","message","textarea","Message",{"_uid":693,"name":694,"type":578,"label":695,"options":696,"required":33,"component":570,"conditions":697,"placeholder":13},"8a3c9f85-f438-427d-9c7a-d7b295a14b5b","existing_user","Are you an existing user?","No, Yes",[698],{"_uid":699,"equals":700,"fields":701,"component":637},"115933d6-262a-4b59-8fa8-579c5ad73de1","Yes",[702],{"_uid":703,"name":704,"type":332,"label":705,"options":13,"required":33,"component":570,"conditions":706,"placeholder":13},"44b6ff23-98f0-4e95-b7f5-c23e06415c2d","subdomain","Store Subdomain",[],{"_uid":708,"name":709,"type":578,"label":710,"options":711,"required":33,"component":570,"conditions":712,"placeholder":13},"922a5cef-3af2-4113-8855-36c7910e3ee3","user_type","What type of user are you?","Developer, Designer, Merchant",[],"POST",[715],{"_uid":716,"text":717,"title":726,"component":727},"7323b90d-a93a-4bf1-baa9-20d0b7ead61b",{"type":324,"content":718},[719],{"type":327,"content":720},[721,723,724],{"text":722,"type":332},"855.369.9227",{"type":605},{"text":725,"type":332},"9:30am-6pm Central M-F","Pre-sales, Sales, & Partnerships","contact___footer_column",{"type":324,"content":729},[730],{"type":327,"content":731},[732],{"text":733,"type":332},"Get in touch to get help from our friendly support team.","Submit","Success!","Your email has been received. We'll get back to you as soon as we can, but it might take a business day. If you don't hear back from us in a timely manner, please check your spam folder to ensure our reply didn't go there.",-80,[],"2fd9fb7d-a48a-4184-acfd-30022d8d6f08","2022-09-23T20:10:45.360Z",[],[288,743,771,804],{"name":744,"created_at":745,"published_at":746,"updated_at":747,"id":748,"uuid":749,"content":750,"slug":764,"full_slug":765,"sort_by_date":59,"position":766,"tag_list":767,"is_startpage":24,"parent_id":310,"meta_data":59,"group_id":768,"first_published_at":769,"release_id":59,"lang":65,"path":59,"alternates":770,"default_full_slug":59,"translated_slugs":59},"Products","2023-01-19T16:20:53.075Z","2024-06-05T04:29:14.851Z","2024-06-05T04:29:14.872Z",28236,"389d5512-29ba-4a93-9cfa-9491d1618f73",{"_uid":751,"icon":752,"name":744,"guides":753,"pinned":24,"summary":754,"category":13,"component":297,"blog_posts":755,"content_hub":24,"icon_custom":756,"case_studies":757,"faq_sections":758,"help_articles":759,"featured_guides":760,"mailbox_category":13,"featured_articles":761,"featured_blog_posts":762,"featured_case_studies":763},"3551f6e8-765a-4b8d-8587-2e2eda4d2b23","fa-tags",[],"How products work, supported product types, inventory management, and more.",[],{"id":59,"alt":59,"name":13,"focus":59,"title":59,"filename":13,"copyright":59,"fieldtype":81},[],[],[],[],[],[],[],"products","help\u002Fcategories\u002Fproducts",150,[],"c025c7a7-0d20-4244-938a-c8d6588e1269","2023-01-19T17:25:32.570Z",[],{"name":772,"created_at":773,"published_at":774,"updated_at":775,"id":776,"uuid":777,"content":778,"slug":797,"full_slug":798,"sort_by_date":59,"position":799,"tag_list":800,"is_startpage":24,"parent_id":310,"meta_data":59,"group_id":801,"first_published_at":802,"release_id":59,"lang":65,"path":59,"alternates":803,"default_full_slug":59,"translated_slugs":59},"Subscriptions","2023-01-19T16:24:14.726Z","2026-06-10T18:52:11.987Z","2026-06-10T18:52:11.999Z",28240,"c7d66085-8f6f-4677-ae1b-d4595f6c3c3c",{"_uid":779,"icon":13,"name":772,"type":780,"guides":781,"pinned":24,"summary":782,"category":749,"component":297,"blog_posts":783,"content_hub":24,"icon_custom":784,"case_studies":785,"faq_sections":786,"help_articles":787,"featured_guides":788,"mailbox_category":13,"featured_articles":789,"featured_blog_posts":793,"featured_case_studies":796},"39561099-e75b-4cb5-a6a9-17632ca23669","simple",[],"Everything you need to set up and manage subscription and recurring billing products in your Foxy store.",[],{"id":59,"alt":59,"name":13,"focus":59,"title":59,"filename":13,"copyright":59,"fieldtype":81},[],[],[],[],[790,791,792],"54c01e5d-67e2-4732-b110-7e046e509913","b4b6742e-c901-47e3-b70e-70d0ad1a6355","7ad67a5c-bafd-49b6-b5e3-a66effe7023b",[794,795],"3591c0bd-d883-491d-b463-2fda98f08681","64edff39-9a8e-48e3-aed2-51e9f8250305",[],"subscriptions","help\u002Fcategories\u002Fsubscriptions",120,[],"095a0e9a-b656-43af-8fda-421bf90c7ab6","2023-01-24T10:29:16.303Z",[],{"name":805,"created_at":806,"published_at":807,"updated_at":808,"id":809,"uuid":529,"content":810,"slug":822,"full_slug":823,"sort_by_date":59,"position":824,"tag_list":825,"is_startpage":24,"parent_id":310,"meta_data":59,"group_id":826,"first_published_at":807,"release_id":59,"lang":65,"path":59,"alternates":827,"default_full_slug":59,"translated_slugs":59},"Manage Subscriptions","2026-06-10T18:09:46.977Z","2026-06-10T18:52:10.730Z","2026-06-10T18:52:10.741Z",186062385105966,{"_uid":811,"icon":13,"name":805,"type":780,"pinned":24,"summary":812,"category":777,"component":297,"blog_posts":813,"icon_custom":814,"case_studies":816,"faq_sections":817,"featured_guides":818,"mailbox_category":13,"featured_articles":819,"featured_blog_posts":820,"featured_case_studies":821},"27f0faa6-eaab-458a-b8fc-dab43fa306cc","How to modify, update, and cancel subscriptions in Foxy, for both store admins and customers.",[],{"id":59,"alt":59,"name":13,"focus":59,"title":59,"source":59,"filename":13,"copyright":59,"fieldtype":81,"meta_data":815},{},[],[],[],[],[],[],"manage-subscriptions","help\u002Fcategories\u002Fmanage-subscriptions",-350,[],"b78d3c74-6168-434c-802c-95e82dd4ac95",[],{},1784562226806]