[{"data":1,"prerenderedAt":822},["ShallowReactive",2],{"header:help":3,"footer:default":67,"story:navigation\u002Fsearch:help":250,"story:help\u002Fcategories":288,"story:help\u002Fcategories\u002Fcustomize-the-checkout":314,"help:categories:c86d4c1b-9299-4716-802e-52f91ac178b0":341,"help:guides:c86d4c1b-9299-4716-802e-52f91ac178b0":342,"help:tree:c86d4c1b-9299-4716-802e-52f91ac178b0":343,"help:articles:c86d4c1b-9299-4716-802e-52f91ac178b0":371,"story:contact":630,"_apollo:default":821},{"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":335,"full_slug":336,"sort_by_date":59,"position":337,"tag_list":338,"is_startpage":24,"parent_id":310,"meta_data":59,"group_id":339,"first_published_at":317,"release_id":59,"lang":65,"path":59,"alternates":340,"default_full_slug":59,"translated_slugs":59},"Customize The Checkout","2026-07-01T21:47:44.740Z","2026-07-01T21:49:01.723Z","2026-07-01T21:49:01.735Z",193547734023485,"c86d4c1b-9299-4716-802e-52f91ac178b0",{"_uid":322,"icon":13,"name":315,"type":323,"pinned":24,"summary":324,"category":325,"component":297,"blog_posts":326,"icon_custom":327,"case_studies":329,"faq_sections":330,"featured_guides":331,"mailbox_category":13,"featured_articles":332,"featured_blog_posts":333,"featured_case_studies":334},"ef453f74-3f14-4304-9824-ab8062d98dc3","simple","Customize the appearance and fields of the checkout.","60b73dc2-7635-487c-bd1f-fd7fba18ab4d",[],{"id":59,"alt":59,"name":13,"focus":59,"title":59,"source":59,"filename":13,"copyright":59,"fieldtype":81,"meta_data":328},{},[],[],[],[],[],[],"customize-the-checkout","help\u002Fcategories\u002Fcustomize-the-checkout",-500,[],"1d9305ee-1c27-453b-a461-c993ef5b69b5",[],[],[],[288,344],{"name":345,"created_at":346,"published_at":347,"updated_at":348,"id":349,"uuid":325,"content":350,"slug":364,"full_slug":365,"sort_by_date":59,"position":366,"tag_list":367,"is_startpage":24,"parent_id":310,"meta_data":59,"group_id":368,"first_published_at":369,"release_id":59,"lang":65,"path":59,"alternates":370,"default_full_slug":59,"translated_slugs":59},"Checkout","2024-11-06T19:56:29.907Z","2026-07-02T22:04:34.438Z","2026-07-02T22:04:34.451Z",14898631,{"_uid":351,"icon":13,"name":345,"type":323,"guides":352,"pinned":24,"summary":353,"category":13,"component":297,"blog_posts":354,"content_hub":24,"icon_custom":355,"case_studies":357,"faq_sections":358,"help_articles":359,"featured_guides":360,"mailbox_category":13,"featured_articles":361,"featured_blog_posts":362,"featured_case_studies":363},"0a484217-201f-4f60-a813-d8d8bda736e4",[],"How the checkout works, configuration options, customizations, and advanced integrations.",[],{"id":59,"alt":59,"name":13,"focus":59,"title":59,"source":59,"filename":13,"copyright":59,"fieldtype":81,"meta_data":356},{},[],[],[],[],[],[],[],"checkout","help\u002Fcategories\u002Fcheckout",0,[],"b3bfcd1f-8386-4ed8-9218-2f4c2989a1b2","2024-11-06T19:56:44.870Z",[],[372,526],{"name":373,"created_at":374,"published_at":375,"updated_at":376,"id":377,"uuid":378,"content":379,"slug":519,"full_slug":520,"sort_by_date":59,"position":521,"tag_list":522,"is_startpage":24,"parent_id":523,"meta_data":59,"group_id":524,"first_published_at":375,"release_id":59,"lang":65,"path":59,"alternates":525,"default_full_slug":59,"translated_slugs":59},"Add custom validation to your checkout","2026-07-02T21:34:55.100Z","2026-07-02T21:49:13.671Z","2026-07-02T21:49:13.686Z",193898475976358,"288fc200-cd4a-4077-8bd9-9afe7deeecc2",{"_uid":380,"body":381,"name":373,"image":515,"pinned":24,"summary":517,"category":320,"component":266,"related_articles":518},"98e043bd-faec-48d6-ab67-cb6b1dbcafd8",{"type":382,"content":383},"doc",[384,391,398,437,443,448,453,458,463,468,473],{"type":385,"attrs":386,"content":387},"paragraph",{"textAlign":59},[388],{"text":389,"type":390},"When you need to block checkout unless a specific condition is met — like confirming a customer’s age, or requiring a field only in certain situations — you can add custom JavaScript validation to the checkout.","text",{"type":392,"attrs":393,"content":395},"heading",{"level":394,"textAlign":59},2,[396],{"text":397,"type":390},"Steps",{"type":399,"attrs":400,"content":402},"ordered_list",{"order":401},1,[403,418],{"type":404,"content":405},"list_item",[406],{"type":385,"attrs":407,"content":408},{"textAlign":59},[409,411,416],{"text":410,"type":390},"Add a function to the ",{"text":412,"type":390,"marks":413},"checkout-submit",[414],{"type":415},"code",{"text":417,"type":390}," event in your checkout template.",{"type":404,"content":419},[420],{"type":385,"attrs":421,"content":422},{"textAlign":59},[423,425,429,431,435],{"text":424,"type":390},"Return ",{"text":426,"type":390,"marks":427},"true",[428],{"type":415},{"text":430,"type":390}," to allow the checkout to proceed, or ",{"text":432,"type":390,"marks":433},"false",[434],{"type":415},{"text":436,"type":390}," to block it.",{"type":438,"attrs":439,"content":440},"code_block",{"class":59},[441],{"text":442,"type":390},"\u003Cscript type=\"text\u002Fjavascript\">\nFC.client.on(\"checkout-submit\", function() {\n\n});\n\u003C\u002Fscript>\n",{"type":385,"attrs":444,"content":445},{"textAlign":59},[446],{"text":447,"type":390},"For example, to require customers to be 18 or older based on a custom age field:",{"type":438,"attrs":449,"content":450},{"class":59},[451],{"text":452,"type":390},"\u003Cscript type=\"text\u002Fjavascript\">\nFC.client.on(\"checkout-submit\", function() {\n  var custAge = jQuery(\"#CustomerAge\").val();\n  if (!isNaN(parseFloat(custAge)) && isFinite(custAge) && parseFloat(custAge) >= 18) {\n    return true;\n  } else {\n    alert(\"You must be over the age of 18 to purchase these products\");\n    return false;\n  }\n});\n\u003C\u002Fscript>\n",{"type":392,"attrs":454,"content":455},{"level":394,"textAlign":59},[456],{"text":457,"type":390},"Conditionally requiring a field",{"type":385,"attrs":459,"content":460},{"textAlign":59},[461],{"text":462,"type":390},"You can also use this approach to make a standard field required only in certain situations — for example, requiring a phone number only when the cart contains shippable items. Add this to the footer section of your template configuration’s custom code option:",{"type":438,"attrs":464,"content":465},{"class":59},[466],{"text":467,"type":390},"\u003Cscript type=\"text\u002Fjavascript\" charset=\"utf-8\">\nfunction myCustomDisplayUpdate() {\n  var require_phone = 0;\n  for (p in FC.json.items) {\n    if (FC.json.items[p].delivery_type == \"shipped\") {\n      require_phone = 1;\n    }\n  }\n  if (require_phone == 1) {\n    FC.json.required_fields.push('shipping_phone');\n    FC.json.config.template_config.custom_checkout_field_requirements['billing_phone'] = \"required\";\n  }\n}\nif (FC.json.context == \"checkout\") {\n  FC.client.on(\"ready\", myCustomDisplayUpdate);\n}\n\u003C\u002Fscript>\n",{"type":392,"attrs":469,"content":470},{"level":394,"textAlign":59},[471],{"text":472,"type":390},"Notes",{"type":474,"content":475},"bullet_list",[476,508],{"type":404,"content":477},[478],{"type":385,"attrs":479,"content":480},{"textAlign":59},[481,483,486,488,491,493,496,498,501,503,506],{"text":482,"type":390},"Always return both ",{"text":426,"type":390,"marks":484},[485],{"type":415},{"text":487,"type":390}," and ",{"text":432,"type":390,"marks":489},[490],{"type":415},{"text":492,"type":390}," from your ",{"text":412,"type":390,"marks":494},[495],{"type":415},{"text":497,"type":390}," function. If you only set it to ",{"text":432,"type":390,"marks":499},[500],{"type":415},{"text":502,"type":390}," in the failing case and never explicitly return ",{"text":426,"type":390,"marks":504},[505],{"type":415},{"text":507,"type":390},", the checkout won’t be able to proceed even when your condition passes.",{"type":404,"content":509},[510],{"type":385,"attrs":511,"content":512},{"textAlign":59},[513],{"text":514,"type":390},"You can show and hide custom error messages the same way Foxy does for its own default fields.",{"id":59,"alt":59,"name":13,"focus":59,"title":59,"source":59,"filename":13,"copyright":59,"fieldtype":81,"meta_data":516},{},"How to use the checkout-submit event to add custom JavaScript validation, including conditionally required fields.",[],"add-custom-validation-to-your-checkout","help\u002Farticles\u002Fadd-custom-validation-to-your-checkout",-2880,[],2659,"0403a37d-27b2-4ebe-a744-3412cdd36c40",[],{"name":527,"created_at":528,"published_at":529,"updated_at":530,"id":531,"uuid":532,"content":533,"slug":624,"full_slug":625,"sort_by_date":59,"position":626,"tag_list":627,"is_startpage":24,"parent_id":523,"meta_data":59,"group_id":628,"first_published_at":529,"release_id":59,"lang":65,"path":59,"alternates":629,"default_full_slug":59,"translated_slugs":59},"Style the address autocomplete widget","2026-07-02T21:36:28.624Z","2026-07-02T21:49:13.469Z","2026-07-02T21:49:13.483Z",193898859054760,"62502501-f792-4d06-b328-25c84cd9ead5",{"_uid":534,"body":535,"name":527,"image":620,"pinned":24,"summary":622,"category":320,"component":266,"related_articles":623},"b9493d75-3fb1-4b02-a7a3-cb9dbc7bfabd",{"type":382,"content":536},[537,542,546,586,590],{"type":385,"attrs":538,"content":539},{"textAlign":59},[540],{"text":541,"type":390},"The address autocomplete widget ships with default styles so it displays cleanly out of the box. To customize it further, overwrite its styles the same way you would style any other part of the checkout.",{"type":392,"attrs":543,"content":544},{"level":394,"textAlign":59},[545],{"text":397,"type":390},{"type":399,"attrs":547,"content":548},{"order":401},[549,556],{"type":404,"content":550},[551],{"type":385,"attrs":552,"content":553},{"textAlign":59},[554],{"text":555,"type":390},"Overwrite the widget’s CSS in your checkout template, as you would for any other checkout element.",{"type":404,"content":557},[558],{"type":385,"attrs":559,"content":560},{"textAlign":59},[561,563,567,568,572,574,578,580,584],{"text":562,"type":390},"If you need to resize the dropdown selector, set its ",{"text":564,"type":390,"marks":565},"width",[566],{"type":415},{"text":487,"type":390},{"text":569,"type":390,"marks":570},"height",[571],{"type":415},{"text":573,"type":390}," with ",{"text":575,"type":390,"marks":576},"!important",[577],{"type":415},{"text":579,"type":390}," — for example, ",{"text":581,"type":390,"marks":582},"width: 30px !important;",[583],{"type":415},{"text":585,"type":390},". These styles need to override the widget’s own positioning logic, which won’t apply otherwise.",{"type":392,"attrs":587,"content":588},{"level":394,"textAlign":59},[589],{"text":472,"type":390},{"type":474,"content":591},[592,599,606,613],{"type":404,"content":593},[594],{"type":385,"attrs":595,"content":596},{"textAlign":59},[597],{"text":598,"type":390},"The dropdown selector and flag icon are positioned absolutely, based on the size and position of the location text input. The dropdown’s width and height match the text input’s height, including padding, and it sits on the right side of the field.",{"type":404,"content":600},[601],{"type":385,"attrs":602,"content":603},{"textAlign":59},[604],{"text":605,"type":390},"When the dropdown is present, the text input’s typeable width is reduced by the dropdown’s width, so the input’s overall size doesn’t change but text can’t be entered underneath the dropdown button.",{"type":404,"content":607},[608],{"type":385,"attrs":609,"content":610},{"textAlign":59},[611],{"text":612,"type":390},"The flag icon sits to the right of the text input, and to the left of the dropdown selector if one is present.",{"type":404,"content":614},[615],{"type":385,"attrs":616,"content":617},{"textAlign":59},[618],{"text":619,"type":390},"For most custom templates, the default positioning works without adjustment — this is only needed if your design requires a different dropdown size.",{"id":59,"alt":59,"name":13,"focus":59,"title":59,"source":59,"filename":13,"copyright":59,"fieldtype":81,"meta_data":621},{},"How to customize the styling and dimensions of the checkout's address autocomplete widget.",[],"style-the-address-autocomplete-widget","help\u002Farticles\u002Fstyle-the-address-autocomplete-widget",-2890,[],"0bbddb38-8a41-4d9f-bfc9-1a0407c8e25e",[],{"name":631,"created_at":632,"published_at":633,"updated_at":634,"id":635,"uuid":47,"content":636,"slug":48,"full_slug":48,"sort_by_date":59,"position":816,"tag_list":817,"is_startpage":24,"parent_id":59,"meta_data":59,"group_id":818,"first_published_at":819,"release_id":59,"lang":65,"path":59,"alternates":820,"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":637,"_uid":640,"title":641,"action":642,"fields":643,"method":792,"columns":793,"subtitle":807,"component":48,"button_text":813,"submit_title":814,"submit_subtitle":815},{"_uid":638,"title":631,"plugin":639,"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",[644,649,653,763,766,771,786],{"_uid":645,"name":646,"type":390,"label":647,"options":13,"required":33,"component":648,"placeholder":13},"9a70b226-2036-4f90-a052-b3efa61c5896","name","Name","form___field",{"_uid":650,"name":651,"type":651,"label":652,"options":13,"required":33,"component":648,"placeholder":13},"86ba35be-ff43-4a28-8633-14052a8f6622","email","Email Address",{"_uid":654,"name":655,"type":656,"label":657,"options":658,"required":33,"component":648,"conditions":659,"placeholder":13},"3f827475-492c-4f97-aa1e-2386ac263b6c","topic","select","Topic","Presales, Support, Billing, Partnerships, Order Enquiry, Other",[660,717,727,734,742,750,756],{"_uid":661,"equals":662,"fields":663,"component":716},"e21d97dd-e68e-4fa6-ba97-bc40f3041dde","Order Enquiry",[664],{"_uid":665,"body":666,"type":714,"title":13,"component":715},"b64992bc-6d53-48b8-b7a0-d81e5a062e50",{"type":382,"content":667},[668],{"type":385,"content":669},[670,672,680,682,684,685,690,692,697,705,707,712],{"text":671,"type":390},"We are ",{"text":673,"type":390,"marks":674},"Foxy.io",[675],{"type":676,"attrs":677},"link",{"href":678,"uuid":59,"anchor":59,"custom":679,"target":59,"linktype":31},"http:\u002F\u002FFoxy.io",{},{"text":681,"type":390},", 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":683},"hard_break",{"type":683},{"text":686,"type":390,"marks":687},"NOTE:",[688],{"type":689},"bold",{"text":691,"type":390}," We are ",{"text":693,"type":390,"marks":694},"not ",[695],{"type":696},"italic",{"text":698,"type":390,"marks":699},"Foxy.in",[700,704],{"type":676,"attrs":701},{"href":702,"uuid":59,"anchor":59,"custom":703,"target":59,"linktype":31},"http:\u002F\u002FFoxy.in",{},{"type":696},{"text":706,"type":390},". We are not in any way affiliated with ",{"text":698,"type":390,"marks":708},[709],{"type":676,"attrs":710},{"href":702,"uuid":59,"anchor":59,"custom":711,"target":59,"linktype":31},{},{"text":713,"type":390},", and cannot help in any way with your order from that website.","danger","global___alert","form___condition",{"_uid":718,"equals":719,"fields":720,"component":716},"8765c3e1-25cf-44aa-b8ea-fc6094acf9c3","Presales",[721],{"_uid":722,"name":723,"type":724,"label":13,"options":13,"required":24,"component":648,"conditions":725,"placeholder":13,"default_value":726},"cf464f8e-d643-4f6e-af29-d3abffaf7380","department_email_address","hidden",[],"hello@foxy.io",{"_uid":728,"equals":208,"fields":729,"component":716},"4007b6d8-77e5-421d-bd1e-6f336dd853fb",[730],{"_uid":731,"name":723,"type":724,"label":13,"options":13,"required":24,"component":648,"conditions":732,"placeholder":13,"default_value":733},"7b4c6aa5-a68c-45e0-9ce1-0a36af10c0c2",[],"help@foxy.io",{"_uid":735,"equals":736,"fields":737,"component":716},"1dbb8f11-613d-43cd-9e09-1b94f6e19219","Billing",[738],{"_uid":739,"name":723,"type":724,"label":13,"options":13,"required":24,"component":648,"conditions":740,"placeholder":13,"default_value":741},"a0ac0d1b-bc4f-4a6c-a682-581d450b0b73",[],"help+billing@foxy.io",{"_uid":743,"equals":744,"fields":745,"component":716},"a0a53a50-7172-4a29-ba58-181e38874e12","Partnerships",[746],{"_uid":747,"name":723,"type":724,"label":13,"options":13,"required":24,"component":648,"conditions":748,"placeholder":13,"default_value":749},"7aa011d9-f374-4aed-b5a5-929b54aaf152",[],"partners@foxy.io",{"_uid":751,"equals":662,"fields":752,"component":716},"a4cd431f-25d5-41c7-bfdc-02c908c8fb47",[753],{"_uid":754,"name":723,"type":724,"label":13,"options":13,"required":24,"component":648,"conditions":755,"placeholder":13,"default_value":726},"f5d52168-d6ae-451b-94ee-2ced1cbd28ad",[],{"_uid":757,"equals":758,"fields":759,"component":716},"25aba1ed-eb41-4bbc-aa89-f7a7167ea86e","Other",[760],{"_uid":761,"name":723,"type":724,"label":13,"options":13,"required":24,"component":648,"conditions":762,"placeholder":13,"default_value":726},"f40dfaef-c203-4b71-bf4e-e1b43cef192b",[],{"_uid":764,"component":765},"e9c53a05-f40a-4510-aaf8-bc072a235a0c","form___subject",{"_uid":767,"name":768,"type":769,"label":770,"options":13,"required":33,"component":648,"placeholder":13},"a4c4d385-fff4-4978-99fb-b68cfea623d6","message","textarea","Message",{"_uid":772,"name":773,"type":656,"label":774,"options":775,"required":33,"component":648,"conditions":776,"placeholder":13},"8a3c9f85-f438-427d-9c7a-d7b295a14b5b","existing_user","Are you an existing user?","No, Yes",[777],{"_uid":778,"equals":779,"fields":780,"component":716},"115933d6-262a-4b59-8fa8-579c5ad73de1","Yes",[781],{"_uid":782,"name":783,"type":390,"label":784,"options":13,"required":33,"component":648,"conditions":785,"placeholder":13},"44b6ff23-98f0-4e95-b7f5-c23e06415c2d","subdomain","Store Subdomain",[],{"_uid":787,"name":788,"type":656,"label":789,"options":790,"required":33,"component":648,"conditions":791,"placeholder":13},"922a5cef-3af2-4113-8855-36c7910e3ee3","user_type","What type of user are you?","Developer, Designer, Merchant",[],"POST",[794],{"_uid":795,"text":796,"title":805,"component":806},"7323b90d-a93a-4bf1-baa9-20d0b7ead61b",{"type":382,"content":797},[798],{"type":385,"content":799},[800,802,803],{"text":801,"type":390},"855.369.9227",{"type":683},{"text":804,"type":390},"9:30am-6pm Central M-F","Pre-sales, Sales, & Partnerships","contact___footer_column",{"type":382,"content":808},[809],{"type":385,"content":810},[811],{"text":812,"type":390},"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",[],{},1784651826291]