[{"data":1,"prerenderedAt":3542},["ShallowReactive",2],{"header:help":3,"footer:default":67,"story:navigation\u002Fsearch:help":250,"story:help\u002Fcategories":288,"story:help\u002Farticles\u002Fadd-a-handling-fee-to-a-category":314,"no-guide:add-a-handling-fee-to-a-category":59,"article:\u002Fhelp\u002Farticles\u002Fadd-a-handling-fee-to-a-category":3284,"story:contact":3300,"help:tree:9fc18aa5-4369-4d56-833c-adec8fc9f859":3487,"_apollo:default":3541},{"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":3278,"full_slug":3279,"sort_by_date":59,"position":3280,"tag_list":3281,"is_startpage":24,"parent_id":824,"meta_data":59,"group_id":3282,"first_published_at":317,"release_id":59,"lang":65,"path":59,"alternates":3283,"default_full_slug":59,"translated_slugs":59},"Add a Handling Fee to a Category","2026-06-03T20:54:02.012Z","2026-06-03T20:57:51.169Z","2026-06-03T20:57:51.183Z",183625490530716,"9fc18aa5-4369-4d56-833c-adec8fc9f859",{"_uid":322,"body":323,"name":315,"image":514,"pinned":24,"summary":516,"category":517,"component":266,"related_articles":518},"df6e229f-180e-4f21-8bc1-cb89385f2ebe",{"type":324,"content":325},"doc",[326,334,340,345,494,499,504,509],{"type":327,"attrs":328,"content":330},"heading",{"level":329,"textAlign":59},2,[331],{"text":332,"type":333},"Overview","text",{"type":335,"attrs":336,"content":337},"paragraph",{"textAlign":59},[338],{"text":339,"type":333},"This article walks through adding a handling fee to a category. Handling fees are configured per category and are added on top of other shipping costs. For the calculation methods and how fees combine, see [Handling Fees].",{"type":327,"attrs":341,"content":342},{"level":329,"textAlign":59},[343],{"text":344,"type":333},"Steps",{"type":346,"attrs":347,"content":349},"ordered_list",{"order":348},1,[350,365,372,391,462,475,487],{"type":351,"content":352},"list_item",[353],{"type":335,"attrs":354,"content":355},{"textAlign":59},[356,358,363],{"text":357,"type":333},"In the Foxy admin, open the ",{"text":359,"type":333,"marks":360},"Categories",[361],{"type":362},"bold",{"text":364,"type":333}," section.",{"type":351,"content":366},[367],{"type":335,"attrs":368,"content":369},{"textAlign":59},[370],{"text":371,"type":333},"Select the category you want to configure.",{"type":351,"content":373},[374],{"type":335,"attrs":375,"content":376},{"textAlign":59},[377,379,383,385,389],{"text":378,"type":333},"In ",{"text":380,"type":333,"marks":381},"Category details",[382],{"type":362},{"text":384,"type":333},", scroll to ",{"text":386,"type":333,"marks":387},"Handling Fees and Discounts",[388],{"type":362},{"text":390,"type":333},".",{"type":351,"content":392},[393,404],{"type":335,"attrs":394,"content":395},{"textAlign":59},[396,398,402],{"text":397,"type":333},"Set ",{"text":399,"type":333,"marks":400},"Handling fee type",[401],{"type":362},{"text":403,"type":333}," to one of:",{"type":405,"content":406},"bullet_list",[407,418,429,440,451],{"type":351,"content":408},[409],{"type":335,"attrs":410,"content":411},{"textAlign":59},[412,416],{"text":413,"type":333,"marks":414},"No handling fee",[415],{"type":362},{"text":417,"type":333}," — no fee applied.",{"type":351,"content":419},[420],{"type":335,"attrs":421,"content":422},{"textAlign":59},[423,427],{"text":424,"type":333,"marks":425},"Flat fee per shipment",[426],{"type":362},{"text":428,"type":333}," — a single fee when the cart contains products from this category.",{"type":351,"content":430},[431],{"type":335,"attrs":432,"content":433},{"textAlign":59},[434,438],{"text":435,"type":333,"marks":436},"Flat fee per product",[437],{"type":362},{"text":439,"type":333}," — a fee multiplied by the quantity of items from this category.",{"type":351,"content":441},[442],{"type":335,"attrs":443,"content":444},{"textAlign":59},[445,449],{"text":446,"type":333,"marks":447},"Flat fee per shipment + % of price",[448],{"type":362},{"text":450,"type":333}," — a flat fee plus a percentage of the category's item price.",{"type":351,"content":452},[453],{"type":335,"attrs":454,"content":455},{"textAlign":59},[456,460],{"text":457,"type":333,"marks":458},"Flat fee per shipment or % of price, whichever is greater",[459],{"type":362},{"text":461,"type":333}," — Foxy applies the higher of the two.",{"type":351,"content":463},[464],{"type":335,"attrs":465,"content":466},{"textAlign":59},[467,469,473],{"text":468,"type":333},"Enter the ",{"text":470,"type":333,"marks":471},"Handling fee amount",[472],{"type":362},{"text":474,"type":333}," (the flat portion).",{"type":351,"content":476},[477],{"type":335,"attrs":478,"content":479},{"textAlign":59},[480,482,486],{"text":481,"type":333},"If you chose a percentage based type, enter the ",{"text":483,"type":333,"marks":484},"Percentage of price",[485],{"type":362},{"text":390,"type":333},{"type":351,"content":488},[489],{"type":335,"attrs":490,"content":491},{"textAlign":59},[492],{"text":493,"type":333},"Save the category (the checkmark button at the top).",{"type":327,"attrs":495,"content":496},{"level":329,"textAlign":59},[497],{"text":498,"type":333},"Note",{"type":335,"attrs":500,"content":501},{"textAlign":59},[502],{"text":503,"type":333},"Handling fees do not apply to categories set to \"no shipping.\" They combine with live rates and flat rates from other categories and are folded into the total shipping cost shown at checkout (not displayed as a separate line item).",{"type":327,"attrs":505,"content":506},{"level":329,"textAlign":59},[507],{"text":508,"type":333},"Test it",{"type":335,"attrs":510,"content":511},{"textAlign":59},[512],{"text":513,"type":333},"Add a product from this category to your cart and proceed to checkout. The handling fee should be included in the shipping total.",{"id":59,"alt":59,"name":13,"focus":59,"title":59,"source":59,"filename":13,"copyright":59,"fieldtype":81,"meta_data":515},{},"Step by step: add a handling fee on a product category.","71d1bced-5566-4857-bf08-4b47118e2b9b",[519,2262,2633],{"name":520,"created_at":521,"published_at":522,"updated_at":523,"id":524,"uuid":525,"content":526,"slug":1518,"full_slug":1519,"sort_by_date":59,"position":1520,"tag_list":2260,"is_startpage":24,"parent_id":824,"meta_data":59,"group_id":1522,"first_published_at":522,"release_id":59,"lang":65,"path":59,"alternates":2261,"default_full_slug":59,"translated_slugs":59,"_stopResolving":33},"Handling Fees Overview","2026-05-27T19:14:56.085Z","2026-05-28T21:09:23.644Z","2026-05-28T21:09:23.661Z",181123875219162,"e89acdb0-1835-45cf-9b19-fb18fb87aa4f",{"_uid":527,"body":528,"name":520,"image":654,"pinned":24,"summary":656,"category":517,"component":266,"related_articles":657},"30548e08-ab85-4d82-b5b3-5c0c15fca904",{"type":324,"content":529},[530,534,539,544,549,593,598,603,608],{"type":327,"attrs":531,"content":532},{"level":329,"textAlign":59},[533],{"text":332,"type":333},{"type":335,"attrs":535,"content":536},{"textAlign":59},[537],{"text":538,"type":333},"Handling fees let you add extra charges on top of other shipping costs for a specific product category. Like flat rates, handling fees are configured per category. Unlike flat rates (which are a standalone shipping method), handling fees are added on top of live rates or flat rates. Handling fees do not apply if a category's delivery type is set to \"no shipping.\"",{"type":327,"attrs":540,"content":541},{"level":329,"textAlign":59},[542],{"text":543,"type":333},"Handling fee types",{"type":335,"attrs":545,"content":546},{"textAlign":59},[547],{"text":548,"type":333},"When configuring a category's handling fee, you can choose from four calculation methods:",{"type":405,"content":550},[551,561,571,582],{"type":351,"content":552},[553],{"type":335,"attrs":554,"content":555},{"textAlign":59},[556,559],{"text":424,"type":333,"marks":557},[558],{"type":362},{"text":560,"type":333}," — a single fixed fee applied once when the cart contains any products from this category.",{"type":351,"content":562},[563],{"type":335,"attrs":564,"content":565},{"textAlign":59},[566,569],{"text":435,"type":333,"marks":567},[568],{"type":362},{"text":570,"type":333}," — a fixed fee multiplied by the number of products from this category in the cart.",{"type":351,"content":572},[573],{"type":335,"attrs":574,"content":575},{"textAlign":59},[576,580],{"text":577,"type":333,"marks":578},"Flat fee per shipment + percentage of price",[579],{"type":362},{"text":581,"type":333}," — a fixed fee plus a percentage of the total price of products in this category.",{"type":351,"content":583},[584],{"type":335,"attrs":585,"content":586},{"textAlign":59},[587,591],{"text":588,"type":333,"marks":589},"Flat fee per shipment OR percentage of order total (whichever is greater)",[590],{"type":362},{"text":592,"type":333}," — Foxy calculates both and applies the higher amount.",{"type":327,"attrs":594,"content":595},{"level":329,"textAlign":59},[596],{"text":597,"type":333},"How handling fees combine",{"type":335,"attrs":599,"content":600},{"textAlign":59},[601],{"text":602,"type":333},"Handling fees are added to the shipping total alongside any live rates and flat rates from other categories. They're not displayed as a separate line item to the customer; they're folded into the combined shipping cost.",{"type":327,"attrs":604,"content":605},{"level":329,"textAlign":59},[606],{"text":607,"type":333},"Handling fees and custom shipping code",{"type":335,"attrs":609,"content":610},{"textAlign":59},[611,613,622,624,629,631,635,637,641,642,646,648,652],{"text":612,"type":333},"If you're using ",{"text":614,"type":333,"marks":615},"Custom Shipping Code",[616],{"type":617,"attrs":618},"link",{"href":619,"uuid":620,"anchor":59,"target":621,"linktype":14},"\u002Fhelp\u002Farticles\u002Fcustom-shipping-code-overview","cec1151a-658b-481b-a38e-734203e38360","_self",{"text":623,"type":333}," to add rates with ",{"text":625,"type":333,"marks":626},"rates.add()",[627],{"type":628},"code",{"text":630,"type":333},", those custom rates do not automatically include handling fees or flat rates from other categories. The API provides helper methods (",{"text":632,"type":333,"marks":633},"rates.addHandling()",[634],{"type":628},{"text":636,"type":333},", ",{"text":638,"type":333,"marks":639},"rates.addFlatRate()",[640],{"type":628},{"text":636,"type":333},{"text":643,"type":333,"marks":644},"rates.addHandlingAndFlatRate()",[645],{"type":628},{"text":647,"type":333},") to explicitly include them, and corresponding ",{"text":649,"type":333,"marks":650},"remove",[651],{"type":628},{"text":653,"type":333}," methods if you need to strip them out. See the Custom Shipping Code API Reference for details.",{"id":59,"alt":59,"name":13,"focus":59,"title":59,"source":59,"filename":13,"copyright":59,"fieldtype":81,"meta_data":655},{},"Add handling charges to shipping on a per category basis.",[658,828,1612,1667],{"name":659,"created_at":660,"published_at":661,"updated_at":662,"id":663,"uuid":664,"content":665,"slug":820,"full_slug":821,"sort_by_date":59,"position":822,"tag_list":823,"is_startpage":24,"parent_id":824,"meta_data":59,"group_id":825,"first_published_at":826,"release_id":59,"lang":65,"path":59,"alternates":827,"default_full_slug":59,"translated_slugs":59,"_stopResolving":33},"How does Shipping Work?","2026-05-27T19:09:03.903Z","2026-07-09T16:00:10.830Z","2026-07-09T16:00:10.844Z",181122432663877,"16cb7908-cbc7-4901-af7a-16bcfae70597",{"_uid":666,"body":667,"name":659,"image":810,"pinned":24,"summary":812,"category":813,"component":266,"related_articles":814},"f4ee2a83-fc23-45ca-bd4d-28c05a48e7ee",{"type":324,"content":668},[669,675,680,694,699,778,783,805],{"type":327,"attrs":670,"content":671},{"level":329,"textAlign":59},[672],{"text":332,"type":333,"marks":673},[674],{"type":362},{"type":335,"attrs":676,"content":677},{"textAlign":59},[678],{"text":679,"type":333},"Foxy provides several approaches to shipping, from integrated carrier rates to fully custom logic. You can mix and match these across your store's product categories, and Foxy will combine all applicable shipping costs when presenting options to your customers.",{"type":335,"attrs":681,"content":682},{"textAlign":59},[683,685,692],{"text":684,"type":333},"Shipping configuration happens in two places. At the store level, you define what's available (carriers, custom endpoints, free shipping options). At the category level, you choose which approach applies to each group of products and set options like flat rates and handling fees. See ",{"text":686,"type":333,"marks":687},"Shipping and Categories",[688],{"type":617,"attrs":689},{"href":690,"uuid":691,"anchor":59,"target":621,"linktype":14},"\u002Fshipping-and-categories","13cfd93c-4733-4510-adbf-857d07f4ac31",{"text":693,"type":333}," for a full explanation of how these two levels work together.",{"type":335,"attrs":695,"content":696},{"textAlign":59},[697],{"text":698,"type":333},"The available shipping methods are:",{"type":405,"content":700},[701,712,723,734,745,756,767],{"type":351,"content":702},[703],{"type":335,"attrs":704,"content":705},{"textAlign":59},[706,710],{"text":707,"type":333,"marks":708},"Live rates",[709],{"type":362},{"text":711,"type":333}," from USPS, UPS, and FedEx, configured store wide and enabled per category.",{"type":351,"content":713},[714],{"type":335,"attrs":715,"content":716},{"textAlign":59},[717,721],{"text":718,"type":333,"marks":719},"Custom Options for free shipping and customer pickup",[720],{"type":362},{"text":722,"type":333}," options for customers in your store's country enabled store wide.",{"type":351,"content":724},[725],{"type":335,"attrs":726,"content":727},{"textAlign":59},[728,732],{"text":729,"type":333,"marks":730},"Flat rates",[731],{"type":362},{"text":733,"type":333}," configured per category, applied once regardless of product quantity.",{"type":351,"content":735},[736],{"type":335,"attrs":737,"content":738},{"textAlign":59},[739,743],{"text":740,"type":333,"marks":741},"Handling fees",[742],{"type":362},{"text":744,"type":333}," per category, with multiple calculation methods (per shipment, per product, percentage based, or whichever is greater).",{"type":351,"content":746},[747],{"type":335,"attrs":748,"content":749},{"textAlign":59},[750,754],{"text":751,"type":333,"marks":752},"No shipping",[753],{"type":362},{"text":755,"type":333}," configured per category, for intangible, downloadable, or non shippable products.",{"type":351,"content":757},[758],{"type":335,"attrs":759,"content":760},{"textAlign":59},[761,765],{"text":762,"type":333,"marks":763},"Custom shipping endpoint",[764],{"type":362},{"text":766,"type":333}," to replace or augment built in rates with your own server side logic.",{"type":351,"content":768},[769],{"type":335,"attrs":770,"content":771},{"textAlign":59},[772,776],{"text":773,"type":333,"marks":774},"Custom shipping code",[775],{"type":362},{"text":777,"type":333}," to add, modify, or remove rates directly in the Foxy admin using JavaScript.",{"type":335,"attrs":779,"content":780},{"textAlign":59},[781],{"text":782,"type":333},"Because a single cart can contain products from multiple categories (each with its own shipping configuration), all applicable rates, flat fees, and handling fees are combined into the final options shown at checkout.",{"type":335,"attrs":784,"content":785},{"textAlign":59},[786,788,794,796,803],{"text":787,"type":333},"For stores that need fully custom or conditional shipping logic (tiered rates, coupon based free shipping, country restrictions, third party rate APIs), see the ",{"text":614,"type":333,"marks":789},[790],{"type":617,"attrs":791},{"href":792,"uuid":793,"anchor":59,"target":621,"linktype":14},"\u002Fhelp\u002Fcategories\u002Fcustom-shipping-code","621d64cc-1acf-415b-9dd9-0492d1a683bf",{"text":795,"type":333}," and ",{"text":797,"type":333,"marks":798},"Custom Shipping Endpoint",[799],{"type":617,"attrs":800},{"href":801,"uuid":802,"anchor":59,"target":621,"linktype":14},"\u002Fhelp\u002Fcategories\u002Fcustom-shipping-endpoint","9bcb6be6-be79-4c34-9523-6422d3e507d1",{"text":804,"type":333}," sections.",{"type":335,"attrs":806,"content":807},{"textAlign":59},[808],{"text":809,"type":333},"If your store integrates with a fulfillment service, see our integrations section for existing solutions like Order Desk.",{"id":59,"alt":59,"name":13,"focus":59,"title":59,"source":59,"filename":13,"copyright":59,"fieldtype":81,"meta_data":811},{},"How to setup and manage shipping inside the Foxy admin.","52fc5e9e-a76f-40c5-8816-7d2cd6628a7b",[815,816,817,818,620,525,819],"b7d2c21b-aa39-4e1f-aea1-4a57bb102f35","abaae8c9-6a8e-422a-b751-168b2a26ebf7","1e8215ab-14b6-4e18-a316-77b336978e75","43bff4e4-e097-42ab-ac9c-c943ea14c7a1","81e3dc1e-5e62-42aa-adf4-7191259b3bb3","how-does-shipping-work","help\u002Farticles\u002Fhow-does-shipping-work",-1800,[],2659,"6d155029-a208-4d4e-9fde-318f1c437276","2026-05-28T21:09:24.896Z",[],{"name":686,"created_at":829,"published_at":830,"updated_at":831,"id":832,"uuid":815,"content":833,"slug":1605,"full_slug":1606,"sort_by_date":59,"position":1607,"tag_list":1608,"is_startpage":24,"parent_id":824,"meta_data":59,"group_id":1609,"first_published_at":1610,"release_id":59,"lang":65,"path":59,"alternates":1611,"default_full_slug":59,"translated_slugs":59,"_stopResolving":33},"2026-05-27T19:09:21.437Z","2026-05-29T19:52:49.076Z","2026-05-29T19:52:49.087Z",181122504487238,{"_uid":834,"body":835,"name":686,"image":993,"pinned":24,"summary":995,"category":813,"component":266,"related_articles":996},"d78e85c6-046e-4668-9873-aa58fa47af03",{"type":324,"content":836},[837,841,846,870,875,882,887,943,950,955,960,983,988],{"type":327,"attrs":838,"content":839},{"level":329,"textAlign":59},[840],{"text":332,"type":333},{"type":335,"attrs":842,"content":843},{"textAlign":59},[844],{"text":845,"type":333},"Shipping in Foxy is configured in two places that work together:",{"type":405,"content":847},[848,859],{"type":351,"content":849},[850],{"type":335,"attrs":851,"content":852},{"textAlign":59},[853,857],{"text":854,"type":333,"marks":855},"Store level",[856],{"type":362},{"text":858,"type":333}," (the Shipping settings page in your admin) is where you define what shipping options are available to your store. This is where you enable carriers like USPS, UPS, and FedEx, configure package defaults, set up a custom shipping endpoint, and enable options like free shipping or customer pickup.",{"type":351,"content":860},[861],{"type":335,"attrs":862,"content":863},{"textAlign":59},[864,868],{"text":865,"type":333,"marks":866},"Category level",[867],{"type":362},{"text":869,"type":333}," (each category's settings) is where you choose which shipping approach applies to products in that category and configure category specific options like flat rates and handling fees.",{"type":335,"attrs":871,"content":872},{"textAlign":59},[873],{"text":874,"type":333},"These two levels are connected. For example, setting a category's delivery type to \"live rates\" only works if you've enabled at least one carrier in your store level shipping settings. The store level defines what's available; the category level applies it to your products.",{"type":327,"attrs":876,"content":877},{"level":329,"textAlign":59},[878],{"text":879,"type":333,"marks":880},"Delivery options per category",[881],{"type":362},{"type":335,"attrs":883,"content":884},{"textAlign":59},[885],{"text":886,"type":333},"Each category's delivery type determines how its shipping is calculated. The available options are:",{"type":405,"content":888},[889,900,911,921,932],{"type":351,"content":890},[891],{"type":335,"attrs":892,"content":893},{"textAlign":59},[894,898],{"text":895,"type":333,"marks":896},"Shipped using live rates",[897],{"type":362},{"text":899,"type":333}," — uses your store's configured carriers (USPS, UPS, FedEx, and your Custom Shipping Code or Endpoint rates)",{"type":351,"content":901},[902],{"type":335,"attrs":903,"content":904},{"textAlign":59},[905,909],{"text":906,"type":333,"marks":907},"Shipped using a flat rate",[908],{"type":362},{"text":910,"type":333}," — a fixed amount applied once for that category",{"type":351,"content":912},[913],{"type":335,"attrs":914,"content":915},{"textAlign":59},[916,919],{"text":751,"type":333,"marks":917},[918],{"type":362},{"text":920,"type":333}," — no shipping cost is added.",{"type":351,"content":922},[923],{"type":335,"attrs":924,"content":925},{"textAlign":59},[926,930],{"text":927,"type":333,"marks":928},"Picked up by the customer ",[929],{"type":362},{"text":931,"type":333},"— no shipping cost is added. ",{"type":351,"content":933},[934],{"type":335,"attrs":935,"content":936},{"textAlign":59},[937,941],{"text":938,"type":333,"marks":939},"Downloaded by the customer ",[940],{"type":362},{"text":942,"type":333},"— no shipping cost is added this is downloadable products hosted in Foxy.",{"type":327,"attrs":944,"content":945},{"level":329,"textAlign":59},[946],{"text":947,"type":333,"marks":948},"How rates combine",[949],{"type":362},{"type":335,"attrs":951,"content":952},{"textAlign":59},[953],{"text":954,"type":333},"A single cart can contain products from multiple categories, each with its own shipping configuration. When this happens, Foxy combines all applicable shipping costs into the options presented at checkout.",{"type":335,"attrs":956,"content":957},{"textAlign":59},[958],{"text":959,"type":333},"Consider a store with four product categories:",{"type":405,"content":961},[962,969,976],{"type":351,"content":963},[964],{"type":335,"attrs":965,"content":966},{"textAlign":59},[967],{"text":968,"type":333},"Two categories set to use live shipping rates",{"type":351,"content":970},[971],{"type":335,"attrs":972,"content":973},{"textAlign":59},[974],{"text":975,"type":333},"One category set to flat rate shipping",{"type":351,"content":977},[978],{"type":335,"attrs":979,"content":980},{"textAlign":59},[981],{"text":982,"type":333},"One category set to no shipping",{"type":335,"attrs":984,"content":985},{"textAlign":59},[986],{"text":987,"type":333},"If a customer has products from all four categories in their cart, the checkout will present all of the returned live rates, each combined with the flat rate fee from the third category. The \"no shipping\" category contributes nothing to the total.",{"type":335,"attrs":989,"content":990},{"textAlign":59},[991],{"text":992,"type":333},"This combining behavior applies across all shipping types. Flat rates, handling fees, and live carrier rates are all added together. Regardless of how many categories are in the cart or what shipping types they use, everything gets combined into a single set of options at checkout.",{"id":59,"alt":59,"name":13,"focus":59,"title":59,"source":59,"filename":13,"copyright":59,"fieldtype":81,"meta_data":994},{},"How store level shipping settings and category level configuration work together.",[997,1116,1415,1524],{"name":659,"created_at":660,"published_at":661,"updated_at":662,"id":663,"uuid":664,"content":998,"slug":820,"full_slug":821,"sort_by_date":59,"position":822,"tag_list":1114,"is_startpage":24,"parent_id":824,"meta_data":59,"group_id":825,"first_published_at":826,"release_id":59,"lang":65,"path":59,"alternates":1115,"default_full_slug":59,"translated_slugs":59,"_stopResolving":33},{"_uid":666,"body":999,"name":659,"image":1111,"pinned":24,"summary":812,"category":813,"component":266,"related_articles":1113},{"type":324,"content":1000},[1001,1007,1011,1020,1024,1089,1093,1107],{"type":327,"attrs":1002,"content":1003},{"level":329,"textAlign":59},[1004],{"text":332,"type":333,"marks":1005},[1006],{"type":362},{"type":335,"attrs":1008,"content":1009},{"textAlign":59},[1010],{"text":679,"type":333},{"type":335,"attrs":1012,"content":1013},{"textAlign":59},[1014,1015,1019],{"text":684,"type":333},{"text":686,"type":333,"marks":1016},[1017],{"type":617,"attrs":1018},{"href":690,"uuid":691,"anchor":59,"target":621,"linktype":14},{"text":693,"type":333},{"type":335,"attrs":1021,"content":1022},{"textAlign":59},[1023],{"text":698,"type":333},{"type":405,"content":1025},[1026,1035,1044,1053,1062,1071,1080],{"type":351,"content":1027},[1028],{"type":335,"attrs":1029,"content":1030},{"textAlign":59},[1031,1034],{"text":707,"type":333,"marks":1032},[1033],{"type":362},{"text":711,"type":333},{"type":351,"content":1036},[1037],{"type":335,"attrs":1038,"content":1039},{"textAlign":59},[1040,1043],{"text":718,"type":333,"marks":1041},[1042],{"type":362},{"text":722,"type":333},{"type":351,"content":1045},[1046],{"type":335,"attrs":1047,"content":1048},{"textAlign":59},[1049,1052],{"text":729,"type":333,"marks":1050},[1051],{"type":362},{"text":733,"type":333},{"type":351,"content":1054},[1055],{"type":335,"attrs":1056,"content":1057},{"textAlign":59},[1058,1061],{"text":740,"type":333,"marks":1059},[1060],{"type":362},{"text":744,"type":333},{"type":351,"content":1063},[1064],{"type":335,"attrs":1065,"content":1066},{"textAlign":59},[1067,1070],{"text":751,"type":333,"marks":1068},[1069],{"type":362},{"text":755,"type":333},{"type":351,"content":1072},[1073],{"type":335,"attrs":1074,"content":1075},{"textAlign":59},[1076,1079],{"text":762,"type":333,"marks":1077},[1078],{"type":362},{"text":766,"type":333},{"type":351,"content":1081},[1082],{"type":335,"attrs":1083,"content":1084},{"textAlign":59},[1085,1088],{"text":773,"type":333,"marks":1086},[1087],{"type":362},{"text":777,"type":333},{"type":335,"attrs":1090,"content":1091},{"textAlign":59},[1092],{"text":782,"type":333},{"type":335,"attrs":1094,"content":1095},{"textAlign":59},[1096,1097,1101,1102,1106],{"text":787,"type":333},{"text":614,"type":333,"marks":1098},[1099],{"type":617,"attrs":1100},{"href":792,"uuid":793,"anchor":59,"target":621,"linktype":14},{"text":795,"type":333},{"text":797,"type":333,"marks":1103},[1104],{"type":617,"attrs":1105},{"href":801,"uuid":802,"anchor":59,"target":621,"linktype":14},{"text":804,"type":333},{"type":335,"attrs":1108,"content":1109},{"textAlign":59},[1110],{"text":809,"type":333},{"id":59,"alt":59,"name":13,"focus":59,"title":59,"source":59,"filename":13,"copyright":59,"fieldtype":81,"meta_data":1112},{},[815,816,817,818,620,525,819],[],[],{"name":1117,"created_at":1118,"published_at":1119,"updated_at":1120,"id":1121,"uuid":816,"content":1122,"slug":1409,"full_slug":1410,"sort_by_date":59,"position":1411,"tag_list":1412,"is_startpage":24,"parent_id":824,"meta_data":59,"group_id":1413,"first_published_at":1119,"release_id":59,"lang":65,"path":59,"alternates":1414,"default_full_slug":59,"translated_slugs":59,"_stopResolving":33},"Live Shipping Rates Overview","2026-05-27T19:09:33.112Z","2026-05-28T21:09:24.515Z","2026-05-28T21:09:24.532Z",181122552308039,{"_uid":1123,"body":1124,"name":1117,"image":1403,"pinned":24,"summary":1405,"category":1406,"component":266,"related_articles":1407},"54b0c29c-739d-4f61-9a08-bdf89e6afb1e",{"type":324,"content":1125},[1126,1130,1144,1153,1158,1171,1228,1233,1241,1246,1253,1258,1263,1276,1283,1288,1293,1298,1333,1356,1361,1366,1371,1376,1381,1386],{"type":327,"attrs":1127,"content":1128},{"level":329,"textAlign":59},[1129],{"text":332,"type":333},{"type":335,"attrs":1131,"content":1132},{"textAlign":59},[1133,1135,1142],{"text":1134,"type":333},"Live shipping rates pull real time pricing from USPS, UPS, and\u002For FedEx based on the shipment's weight, origin, and destination. Carriers are configured at the store level on the Shipping settings page, and then enabled per ",{"text":1136,"type":333,"marks":1137},"category",[1138],{"type":617,"attrs":1139},{"href":1140,"uuid":1141,"anchor":59,"target":621,"linktype":14},"\u002Fhelp\u002Farticles\u002Fproduct-categories-overview","8ae9b378-e102-447d-b0b4-a9a37e58e1f9",{"text":1143,"type":333}," by setting a category's delivery type to \"Shipped using live shipping rates.\"",{"type":335,"attrs":1145,"content":1146},{"textAlign":59},[1147,1151],{"text":1148,"type":333,"marks":1149},"Setting up a carrier is a two step process. ",[1150],{"type":362},{"text":1152,"type":333},"First, you activate the carrier on the Shipping page. Then you enable the specific services (rate types) you want to offer customers, such as Priority Mail, Ground, 2 Day, and so on. Only enabled services will be requested from the carrier and shown at checkout.",{"type":327,"attrs":1154,"content":1155},{"level":329,"textAlign":59},[1156],{"text":1157,"type":333},"Activating a carrier",{"type":335,"attrs":1159,"content":1160},{"textAlign":59},[1161,1163,1169],{"text":1162,"type":333},"Navigate to your store's Shipping page in the ",{"text":1164,"type":333,"marks":1165},"Foxy admin",[1166],{"type":617,"attrs":1167},{"href":1168,"uuid":59,"anchor":59,"target":621,"linktype":31},"https:\u002F\u002Fadmin.foxy.io\u002F",{"text":1170,"type":333},". Under \"Shipping methods\" you'll see entries for USPS, FedEx, and UPS. Click the carrier you want to activate to open its configuration panel, where you can set:",{"type":405,"content":1172},[1173,1184,1195,1206,1217],{"type":351,"content":1174},[1175],{"type":335,"attrs":1176,"content":1177},{"textAlign":59},[1178,1182],{"text":1179,"type":333,"marks":1180},"Container type",[1181],{"type":362},{"text":1183,"type":333}," — the packaging type sent to the carrier for rate calculation. If not specified, dimensions default to 5\"×5\"×5\".",{"type":351,"content":1185},[1186],{"type":335,"attrs":1187,"content":1188},{"textAlign":59},[1189,1193],{"text":1190,"type":333,"marks":1191},"Drop type",[1192],{"type":362},{"text":1194,"type":333}," — how you hand off packages to the carrier (affects rate tiers; see UPS notes below).",{"type":351,"content":1196},[1197],{"type":335,"attrs":1198,"content":1199},{"textAlign":59},[1200,1204],{"text":1201,"type":333,"marks":1202},"Destinations",[1203],{"type":362},{"text":1205,"type":333}," — whether to request rates for domestic shipments, international shipments, or both.",{"type":351,"content":1207},[1208],{"type":335,"attrs":1209,"content":1210},{"textAlign":59},[1211,1215],{"text":1212,"type":333,"marks":1213},"Account",[1214],{"type":362},{"text":1216,"type":333}," — optionally use your own carrier account for negotiated or account based rates. Foxy recommends using your own account so returned rates more accurately reflect what you'll actually pay.",{"type":351,"content":1218},[1219],{"type":335,"attrs":1220,"content":1221},{"textAlign":59},[1222,1226],{"text":1223,"type":333,"marks":1224},"Additional services",[1225],{"type":362},{"text":1227,"type":333}," — the specific rate types you want to enable. They will appear after the carrier has been activated (e.g., Priority Mail, Ground, Express). Only checked services are shown to customers.",{"type":327,"attrs":1229,"content":1230},{"level":329,"textAlign":59},[1231],{"text":1232,"type":333},"Carrier specific notes",{"type":327,"attrs":1234,"content":1236},{"level":1235,"textAlign":59},3,[1237],{"text":1238,"type":333,"marks":1239},"USPS",[1240],{"type":362},{"type":335,"attrs":1242,"content":1243},{"textAlign":59},[1244],{"text":1245,"type":333},"USPS Retail Ground (formerly Standard Post) is generally only available for shipping zones 5 through 9 within the US. If you need a full domestic rate option, look at First Class, Priority Mail, or Ground Advantage instead.",{"type":327,"attrs":1247,"content":1248},{"level":1235,"textAlign":59},[1249],{"text":1250,"type":333,"marks":1251},"UPS",[1252],{"type":362},{"type":335,"attrs":1254,"content":1255},{"textAlign":59},[1256],{"text":1257,"type":333},"UPS Standard in the US is only available for shipments originating in the US with a destination in Canada or Mexico. For domestic US shipments, UPS Ground is typically what you want. Note that UPS Ground will not be returned if you've selected an express container type.",{"type":335,"attrs":1259,"content":1260},{"textAlign":59},[1261],{"text":1262,"type":333},"The drop type you select affects the rate tier UPS returns. Daily Pickup returns wholesale rates; Customer Counter and Suggested Retail Rates return retail rates; One Time Pickup, On Call Air, Letter Center, and Air Service Center return what UPS calls \"occasional\" rates.",{"type":335,"attrs":1264,"content":1265},{"textAlign":59},[1266,1268,1274],{"text":1267,"type":333},"If you want negotiated (account based) rates, go to our legacy admin to the ",{"text":1269,"type":333,"marks":1270},"Integrations page",[1271],{"type":617,"attrs":1272},{"href":1273,"uuid":59,"anchor":59,"target":621,"linktype":31},"https:\u002F\u002Fadmin.foxycart.com\u002Fadmin.php?ThisAction=AddIntegration",{"text":1275,"type":333}," and connect your UPS account to Foxy directly.",{"type":327,"attrs":1277,"content":1278},{"level":1235,"textAlign":59},[1279],{"text":1280,"type":333,"marks":1281},"FedEx",[1282],{"type":362},{"type":335,"attrs":1284,"content":1285},{"textAlign":59},[1286],{"text":1287,"type":333},"FedEx Ground is only available for commercial\u002Fbusiness shipments or packages over 70 lbs. FedEx Home Delivery is the residential counterpart for packages up to 70 lbs. Which one appears depends on the residential\u002Fcommercial setting (see below) and whether the customer enters a company name.",{"type":327,"attrs":1289,"content":1290},{"level":329,"textAlign":59},[1291],{"text":1292,"type":333},"Residential vs commercial",{"type":335,"attrs":1294,"content":1295},{"textAlign":59},[1296],{"text":1297,"type":333},"On the Shipping page, the \"Rate calculation\" dropdown controls how addresses are classified for carrier rate requests:",{"type":405,"content":1299},[1300,1311,1322],{"type":351,"content":1301},[1302],{"type":335,"attrs":1303,"content":1304},{"textAlign":59},[1305,1309],{"text":1306,"type":333,"marks":1307},"Rate as Residential",[1308],{"type":362},{"text":1310,"type":333}," — all rate requests are sent as residential.",{"type":351,"content":1312},[1313],{"type":335,"attrs":1314,"content":1315},{"textAlign":59},[1316,1320],{"text":1317,"type":333,"marks":1318},"Rate as Commercial",[1319],{"type":362},{"text":1321,"type":333}," — all rate requests are sent as commercial.",{"type":351,"content":1323},[1324],{"type":335,"attrs":1325,"content":1326},{"textAlign":59},[1327,1331],{"text":1328,"type":333,"marks":1329},"Rate based on Company field",[1330],{"type":362},{"text":1332,"type":333}," — if the customer enters a company name in the checkout form, the address is rated as commercial; otherwise it's rated as residential.",{"type":335,"attrs":1334,"content":1335},{"textAlign":59},[1336,1338,1342,1344,1348,1350,1354],{"text":1337,"type":333},"You can also override this per transaction using the ",{"text":1339,"type":333,"marks":1340},"h:shipto_residential",[1341],{"type":628},{"text":1343,"type":333}," custom session attribute. Set it to ",{"text":1345,"type":333,"marks":1346},"true",[1347],{"type":628},{"text":1349,"type":333}," or ",{"text":1351,"type":333,"marks":1352},"false",[1353],{"type":628},{"text":1355,"type":333}," as part of an add to cart or JSONP request to force a specific classification for that session.",{"type":327,"attrs":1357,"content":1358},{"level":329,"textAlign":59},[1359],{"text":1360,"type":333},"Multiple packages (max package weight)",{"type":335,"attrs":1362,"content":1363},{"textAlign":59},[1364],{"text":1365,"type":333},"The Shipping page includes an optional \"max package weight\" setting. When set, Foxy calculates how many packages are needed by dividing the total cart weight by the max package weight (rounded up), then divides the total weight evenly across those packages and sends the per package weight to the carriers.",{"type":335,"attrs":1367,"content":1368},{"textAlign":59},[1369],{"text":1370,"type":333},"This means the max package weight is the most any single package will weigh, but not necessarily its exact weight. The package count and individual weight are saved as transaction attributes and visible in the admin's transaction reports and via the API.",{"type":335,"attrs":1372,"content":1373},{"textAlign":59},[1374],{"text":1375,"type":333},"In some cases, splitting into smaller packages may actually produce cheaper rates (for example, two 25 lb packages can be cheaper than one 50 lb package).",{"type":335,"attrs":1377,"content":1378},{"textAlign":59},[1379],{"text":1380,"type":333},"Each carrier has a maximum number of packages it supports per rate request: USPS supports 25, UPS supports 50, and FedEx supports 999. If the computed package count exceeds a carrier's limit, no rate request is made to that carrier. If it exceeds the limits for all selected carriers, customers will see a generic \"no shipping results found\" error.",{"type":327,"attrs":1382,"content":1383},{"level":329,"textAlign":59},[1384],{"text":1385,"type":333},"Custom shipping code and endpoint",{"type":335,"attrs":1387,"content":1388},{"textAlign":59},[1389,1391,1395,1396,1401],{"text":1390,"type":333},"The ",{"text":614,"type":333,"marks":1392},[1393],{"type":617,"attrs":1394},{"href":619,"uuid":620,"anchor":59,"target":621,"linktype":14},{"text":795,"type":333},{"text":797,"type":333,"marks":1397},[1398],{"type":617,"attrs":1399},{"href":1400,"uuid":819,"anchor":59,"target":621,"linktype":14},"\u002Fhelp\u002Farticles\u002Fcustom-shipping-endpoint-overview",{"text":1402,"type":333}," features also require categories to be set to \"Shipped using live shipping rates\" as their delivery type. This is because both features work with dynamic, real time rate calculation. Custom code runs after carrier rates are returned and can modify, add, or remove rates. ",{"id":59,"alt":59,"name":13,"focus":59,"title":59,"source":59,"filename":13,"copyright":59,"fieldtype":81,"meta_data":1404},{},"Set up real time carrier rates from USPS, UPS, and FedEx.","5cb92e14-16e9-4584-8bbf-016ae6ea7171",[664,815,1408,620,819],"7c7777a7-e9ec-4bec-8321-501eb979d2d7","live-shipping-rates-overview","help\u002Farticles\u002Flive-shipping-rates-overview",-1820,[],"fb770878-d121-46a6-b904-2b03dcf6b1ca",[],{"name":520,"created_at":521,"published_at":522,"updated_at":523,"id":524,"uuid":525,"content":1416,"slug":1518,"full_slug":1519,"sort_by_date":59,"position":1520,"tag_list":1521,"is_startpage":24,"parent_id":824,"meta_data":59,"group_id":1522,"first_published_at":522,"release_id":59,"lang":65,"path":59,"alternates":1523,"default_full_slug":59,"translated_slugs":59,"_stopResolving":33},{"_uid":527,"body":1417,"name":520,"image":1514,"pinned":24,"summary":656,"category":517,"component":266,"related_articles":1516},{"type":324,"content":1418},[1419,1423,1427,1431,1435,1473,1477,1481,1485],{"type":327,"attrs":1420,"content":1421},{"level":329,"textAlign":59},[1422],{"text":332,"type":333},{"type":335,"attrs":1424,"content":1425},{"textAlign":59},[1426],{"text":538,"type":333},{"type":327,"attrs":1428,"content":1429},{"level":329,"textAlign":59},[1430],{"text":543,"type":333},{"type":335,"attrs":1432,"content":1433},{"textAlign":59},[1434],{"text":548,"type":333},{"type":405,"content":1436},[1437,1446,1455,1464],{"type":351,"content":1438},[1439],{"type":335,"attrs":1440,"content":1441},{"textAlign":59},[1442,1445],{"text":424,"type":333,"marks":1443},[1444],{"type":362},{"text":560,"type":333},{"type":351,"content":1447},[1448],{"type":335,"attrs":1449,"content":1450},{"textAlign":59},[1451,1454],{"text":435,"type":333,"marks":1452},[1453],{"type":362},{"text":570,"type":333},{"type":351,"content":1456},[1457],{"type":335,"attrs":1458,"content":1459},{"textAlign":59},[1460,1463],{"text":577,"type":333,"marks":1461},[1462],{"type":362},{"text":581,"type":333},{"type":351,"content":1465},[1466],{"type":335,"attrs":1467,"content":1468},{"textAlign":59},[1469,1472],{"text":588,"type":333,"marks":1470},[1471],{"type":362},{"text":592,"type":333},{"type":327,"attrs":1474,"content":1475},{"level":329,"textAlign":59},[1476],{"text":597,"type":333},{"type":335,"attrs":1478,"content":1479},{"textAlign":59},[1480],{"text":602,"type":333},{"type":327,"attrs":1482,"content":1483},{"level":329,"textAlign":59},[1484],{"text":607,"type":333},{"type":335,"attrs":1486,"content":1487},{"textAlign":59},[1488,1489,1493,1494,1497,1498,1501,1502,1505,1506,1509,1510,1513],{"text":612,"type":333},{"text":614,"type":333,"marks":1490},[1491],{"type":617,"attrs":1492},{"href":619,"uuid":620,"anchor":59,"target":621,"linktype":14},{"text":623,"type":333},{"text":625,"type":333,"marks":1495},[1496],{"type":628},{"text":630,"type":333},{"text":632,"type":333,"marks":1499},[1500],{"type":628},{"text":636,"type":333},{"text":638,"type":333,"marks":1503},[1504],{"type":628},{"text":636,"type":333},{"text":643,"type":333,"marks":1507},[1508],{"type":628},{"text":647,"type":333},{"text":649,"type":333,"marks":1511},[1512],{"type":628},{"text":653,"type":333},{"id":59,"alt":59,"name":13,"focus":59,"title":59,"source":59,"filename":13,"copyright":59,"fieldtype":81,"meta_data":1515},{},[664,815,818,1517],"7b057a6e-5277-42ef-8c0e-946e72139991","handling-fees-overview","help\u002Farticles\u002Fhandling-fees-overview",-1850,[],"0d074696-af9d-4472-8821-fd698ecccd4d",[],{"name":1525,"created_at":1526,"published_at":1527,"updated_at":1528,"id":1529,"uuid":818,"content":1530,"slug":1599,"full_slug":1600,"sort_by_date":59,"position":1601,"tag_list":1602,"is_startpage":24,"parent_id":824,"meta_data":59,"group_id":1603,"first_published_at":1527,"release_id":59,"lang":65,"path":59,"alternates":1604,"default_full_slug":59,"translated_slugs":59,"_stopResolving":33},"Flat Rates Overview","2026-05-27T19:09:42.769Z","2026-05-28T21:09:24.144Z","2026-05-28T21:09:24.154Z",181122591859016,{"_uid":1531,"body":1532,"name":1525,"image":1594,"pinned":24,"summary":1596,"category":1597,"component":266,"related_articles":1598},"0541af47-64a9-4707-b1e6-813e3f06ab9c",{"type":324,"content":1533},[1534,1538,1543,1548,1553,1558,1563,1568,1573],{"type":327,"attrs":1535,"content":1536},{"level":329,"textAlign":59},[1537],{"text":332,"type":333},{"type":335,"attrs":1539,"content":1540},{"textAlign":59},[1541],{"text":1542,"type":333},"Flat rate shipping lets you set a fixed shipping cost for a product category. Unlike live rates (which are configured store wide), flat rates are configured directly on each category. The flat rate is applied once per category in the cart, regardless of how many products from that category the customer has added.",{"type":327,"attrs":1544,"content":1545},{"level":329,"textAlign":59},[1546],{"text":1547,"type":333},"How to set it up",{"type":335,"attrs":1549,"content":1550},{"textAlign":59},[1551],{"text":1552,"type":333},"In your Foxy admin, navigate to the category you want to configure. Set the delivery type to \"Flat rate\" and enter the flat rate amount. That's it. When a customer has products from that category in their cart, the flat rate will be added to the shipping total.",{"type":327,"attrs":1554,"content":1555},{"level":329,"textAlign":59},[1556],{"text":1557,"type":333},"How flat rates combine with other shipping",{"type":335,"attrs":1559,"content":1560},{"textAlign":59},[1561],{"text":1562,"type":333},"If a cart contains products from multiple categories, each with different shipping types, all costs are combined. A flat rate category's fee is added on top of any live rates from other categories. For example, if one category returns a $12.50 USPS Priority rate and another category has a $5.00 flat rate, the customer sees $17.50 for that shipping option.",{"type":335,"attrs":1564,"content":1565},{"textAlign":59},[1566],{"text":1567,"type":333},"Flat rates do not appear as a separate line item to the customer. They're folded into the combined shipping total.",{"type":327,"attrs":1569,"content":1570},{"level":329,"textAlign":59},[1571],{"text":1572,"type":333},"When to use flat rate vs other options",{"type":335,"attrs":1574,"content":1575},{"textAlign":59},[1576,1578,1585,1586,1592],{"text":1577,"type":333},"Flat rate works well when shipping cost doesn't depend on weight, destination, or quantity (for example, a category of small accessories that always ships in the same envelope). If you need shipping costs to vary by weight, destination, or cart contents, consider ",{"text":1579,"type":333,"marks":1580},"live rates",[1581],{"type":617,"attrs":1582},{"href":1583,"uuid":1584,"anchor":59,"target":621,"linktype":14},"\u002Flive-shipping-rates-overview","28ee6d13-9c27-4e65-b368-d5e2fce81c78",{"text":1349,"type":333},{"text":1587,"type":333,"marks":1588},"custom shipping",[1589],{"type":617,"attrs":1590},{"href":1591,"uuid":793,"anchor":59,"target":621,"linktype":14},"\u002Fhelp\u002Fcategories\u002Fcustom-shipping",{"text":1593,"type":333}," code instead.",{"id":59,"alt":59,"name":13,"focus":59,"title":59,"source":59,"filename":13,"copyright":59,"fieldtype":81,"meta_data":1595},{},"Charge a fixed shipping amount per product category.","07b08572-434d-4867-a842-c56a235f8dbb",[664,815,525,620],"flat-rates-overview","help\u002Farticles\u002Fflat-rates-overview",-1830,[],"421ed185-d62d-4e23-8642-37ef336fca77",[],"shipping-and-categories","help\u002Farticles\u002Fshipping-and-categories",-1810,[],"0e595dd2-50c3-46e8-9c29-61006d4a6160","2026-05-28T21:09:24.712Z",[],{"name":1525,"created_at":1526,"published_at":1527,"updated_at":1528,"id":1529,"uuid":818,"content":1613,"slug":1599,"full_slug":1600,"sort_by_date":59,"position":1601,"tag_list":1665,"is_startpage":24,"parent_id":824,"meta_data":59,"group_id":1603,"first_published_at":1527,"release_id":59,"lang":65,"path":59,"alternates":1666,"default_full_slug":59,"translated_slugs":59,"_stopResolving":33},{"_uid":1531,"body":1614,"name":1525,"image":1662,"pinned":24,"summary":1596,"category":1597,"component":266,"related_articles":1664},{"type":324,"content":1615},[1616,1620,1624,1628,1632,1636,1640,1644,1648],{"type":327,"attrs":1617,"content":1618},{"level":329,"textAlign":59},[1619],{"text":332,"type":333},{"type":335,"attrs":1621,"content":1622},{"textAlign":59},[1623],{"text":1542,"type":333},{"type":327,"attrs":1625,"content":1626},{"level":329,"textAlign":59},[1627],{"text":1547,"type":333},{"type":335,"attrs":1629,"content":1630},{"textAlign":59},[1631],{"text":1552,"type":333},{"type":327,"attrs":1633,"content":1634},{"level":329,"textAlign":59},[1635],{"text":1557,"type":333},{"type":335,"attrs":1637,"content":1638},{"textAlign":59},[1639],{"text":1562,"type":333},{"type":335,"attrs":1641,"content":1642},{"textAlign":59},[1643],{"text":1567,"type":333},{"type":327,"attrs":1645,"content":1646},{"level":329,"textAlign":59},[1647],{"text":1572,"type":333},{"type":335,"attrs":1649,"content":1650},{"textAlign":59},[1651,1652,1656,1657,1661],{"text":1577,"type":333},{"text":1579,"type":333,"marks":1653},[1654],{"type":617,"attrs":1655},{"href":1583,"uuid":1584,"anchor":59,"target":621,"linktype":14},{"text":1349,"type":333},{"text":1587,"type":333,"marks":1658},[1659],{"type":617,"attrs":1660},{"href":1591,"uuid":793,"anchor":59,"target":621,"linktype":14},{"text":1593,"type":333},{"id":59,"alt":59,"name":13,"focus":59,"title":59,"source":59,"filename":13,"copyright":59,"fieldtype":81,"meta_data":1663},{},[664,815,525,620],[],[],{"name":1668,"created_at":1669,"published_at":1670,"updated_at":1671,"id":1672,"uuid":1517,"content":1673,"slug":2254,"full_slug":2255,"sort_by_date":59,"position":2256,"tag_list":2257,"is_startpage":24,"parent_id":824,"meta_data":59,"group_id":2258,"first_published_at":1670,"release_id":59,"lang":65,"path":59,"alternates":2259,"default_full_slug":59,"translated_slugs":59,"_stopResolving":33},"Custom Shipping Code API Reference","2026-05-27T21:07:12.138Z","2026-05-28T21:09:22.488Z","2026-05-28T21:09:22.506Z",181151466090383,{"_uid":1674,"body":1675,"name":1668,"image":2250,"pinned":24,"summary":2252,"category":793,"component":266,"related_articles":2253},"120eab7d-575a-47fe-aafe-8ed6fd5b6420",{"type":324,"content":1676},[1677,1681,1691,1696,1703,1725,1731,1741,1746,1753,1758,1816,1821,1826,1833,1853,1858,1863,1872,1881,1886,1891,1898,1903,2006,2011,2016,2025,2034,2045,2050,2055,2060,2067,2110,2115,2120,2127,2132,2137,2147,2212,2217,2226,2235,2240],{"type":327,"attrs":1678,"content":1679},{"level":329,"textAlign":59},[1680],{"text":332,"type":333},{"type":335,"attrs":1682,"content":1683},{"textAlign":59},[1684,1685,1689],{"text":1390,"type":333},{"text":1686,"type":333,"marks":1687},"rates",[1688],{"type":628},{"text":1690,"type":333}," object is the primary interface for manipulating shipping rates in Custom Shipping Code. It's pre populated with any rates returned from carriers or the custom endpoint, and all methods are chainable (unless they return a value).",{"type":327,"attrs":1692,"content":1693},{"level":329,"textAlign":59},[1694],{"text":1695,"type":333},"Adding rates",{"type":335,"attrs":1697,"content":1698},{"textAlign":59},[1699],{"text":1700,"type":333,"marks":1701},"rates.add(id, price, method, service_name)",[1702],{"type":628},{"type":335,"attrs":1704,"content":1705},{"textAlign":59},[1706,1708,1712,1714,1718,1719,1723],{"text":1707,"type":333},"Adds a new rate. ",{"text":1709,"type":333,"marks":1710},"id",[1711],{"type":628},{"text":1713,"type":333}," must be 10000 or higher (if you pass a lower number, 10000 is added automatically). At least one of ",{"text":1715,"type":333,"marks":1716},"method",[1717],{"type":628},{"text":1349,"type":333},{"text":1720,"type":333,"marks":1721},"service_name",[1722],{"type":628},{"text":1724,"type":333}," is required. Pass an empty string for the one you don't need.",{"type":1726,"attrs":1727,"content":1728},"code_block",{"class":59},[1729],{"text":1730,"type":333},"rates.add(10001, 5.99, 'FoxyPost', 'Standard');\nrates.add(10002, 0, '', 'Free Shipping');",{"type":335,"attrs":1732,"content":1733},{"textAlign":59},[1734,1736,1739],{"text":1735,"type":333},"Custom rates added with ",{"text":625,"type":333,"marks":1737},[1738],{"type":628},{"text":1740,"type":333}," do not automatically include handling fees or flat rates from other categories. Use the handling\u002Fflat rate helpers (below) if you need to include them.",{"type":327,"attrs":1742,"content":1743},{"level":329,"textAlign":59},[1744],{"text":1745,"type":333},"Filtering rates",{"type":335,"attrs":1747,"content":1748},{"textAlign":59},[1749],{"text":1750,"type":333,"marks":1751},"rates.filter(selector)",[1752],{"type":628},{"type":335,"attrs":1754,"content":1755},{"textAlign":59},[1756],{"text":1757,"type":333},"Returns a new Rates object containing only matching rates. The original collection is not modified. The selector can be:",{"type":405,"content":1759},[1760,1777,1798],{"type":351,"content":1761},[1762],{"type":335,"attrs":1763,"content":1764},{"textAlign":59},[1765,1767,1771,1773],{"text":1766,"type":333},"A ",{"text":1768,"type":333,"marks":1769},"number",[1770],{"type":362},{"text":1772,"type":333}," — matches by ",{"text":1774,"type":333,"marks":1775},"service_id",[1776],{"type":628},{"type":351,"content":1778},[1779],{"type":335,"attrs":1780,"content":1781},{"textAlign":59},[1782,1783,1787,1789,1792,1793,1796],{"text":1766,"type":333},{"text":1784,"type":333,"marks":1785},"string",[1786],{"type":362},{"text":1788,"type":333}," — matches against ",{"text":1715,"type":333,"marks":1790},[1791],{"type":628},{"text":795,"type":333},{"text":1720,"type":333,"marks":1794},[1795],{"type":628},{"text":1797,"type":333}," (case insensitive)",{"type":351,"content":1799},[1800],{"type":335,"attrs":1801,"content":1802},{"textAlign":59},[1803,1805,1809,1811,1814],{"text":1804,"type":333},"An ",{"text":1806,"type":333,"marks":1807},"array of numbers",[1808],{"type":362},{"text":1810,"type":333}," — matches multiple ",{"text":1774,"type":333,"marks":1812},[1813],{"type":628},{"text":1815,"type":333}," values",{"type":1726,"attrs":1817,"content":1818},{"class":59},[1819],{"text":1820,"type":333},"rates.filter(10001).price(0);\nrates.filter('fedex').hide();\nrates.filter([10001, 10002]).price('+5');",{"type":327,"attrs":1822,"content":1823},{"level":329,"textAlign":59},[1824],{"text":1825,"type":333},"Checking if rates exist",{"type":335,"attrs":1827,"content":1828},{"textAlign":59},[1829],{"text":1830,"type":333,"marks":1831},"rates.exists([selector])",[1832],{"type":628},{"type":335,"attrs":1834,"content":1835},{"textAlign":59},[1836,1838,1841,1843,1846,1848,1852],{"text":1837,"type":333},"Returns ",{"text":1345,"type":333,"marks":1839},[1840],{"type":628},{"text":1842,"type":333}," if rates exist. If a selector is provided, returns ",{"text":1345,"type":333,"marks":1844},[1845],{"type":628},{"text":1847,"type":333}," only if matching rates exist. Selector works the same as ",{"text":1849,"type":333,"marks":1850},"filter()",[1851],{"type":628},{"text":390,"type":333},{"type":1726,"attrs":1854,"content":1855},{"class":59},[1856],{"text":1857,"type":333},"if (!rates.exists()) {\n  rates.add(10001, 15, '', 'Fallback Rate');\n}",{"type":327,"attrs":1859,"content":1860},{"level":329,"textAlign":59},[1861],{"text":1862,"type":333},"Showing and hiding rates",{"type":335,"attrs":1864,"content":1865},{"textAlign":59},[1866,1870],{"text":1867,"type":333,"marks":1868},"rates.hide()",[1869],{"type":628},{"text":1871,"type":333}," — hides the matched rates from the customer. Hidden rates remain in the collection and can still be filtered or shown later.",{"type":335,"attrs":1873,"content":1874},{"textAlign":59},[1875,1879],{"text":1876,"type":333,"marks":1877},"rates.show()",[1878],{"type":628},{"text":1880,"type":333}," — makes previously hidden rates visible again.",{"type":1726,"attrs":1882,"content":1883},{"class":59},[1884],{"text":1885,"type":333},"rates.filter('usps').hide();\nrates.filter(10001).show();",{"type":327,"attrs":1887,"content":1888},{"level":329,"textAlign":59},[1889],{"text":1890,"type":333},"Modifying prices",{"type":335,"attrs":1892,"content":1893},{"textAlign":59},[1894],{"text":1895,"type":333,"marks":1896},"rates.price(modifier)",[1897],{"type":628},{"type":335,"attrs":1899,"content":1900},{"textAlign":59},[1901],{"text":1902,"type":333},"Sets or adjusts the price of matched rates. The modifier can be:",{"type":405,"content":1904},[1905,1916],{"type":351,"content":1906},[1907],{"type":335,"attrs":1908,"content":1909},{"textAlign":59},[1910,1911,1914],{"text":1766,"type":333},{"text":1768,"type":333,"marks":1912},[1913],{"type":362},{"text":1915,"type":333}," — sets the price to that exact value",{"type":351,"content":1917},[1918,1927],{"type":335,"attrs":1919,"content":1920},{"textAlign":59},[1921,1922,1925],{"text":1766,"type":333},{"text":1784,"type":333,"marks":1923},[1924],{"type":362},{"text":1926,"type":333}," with an operator prefix:",{"type":405,"content":1928},[1929,1940,1951,1962,1973,1984,1995],{"type":351,"content":1930},[1931],{"type":335,"attrs":1932,"content":1933},{"textAlign":59},[1934,1938],{"text":1935,"type":333,"marks":1936},"'+5'",[1937],{"type":628},{"text":1939,"type":333}," — adds 5 to the current price",{"type":351,"content":1941},[1942],{"type":335,"attrs":1943,"content":1944},{"textAlign":59},[1945,1949],{"text":1946,"type":333,"marks":1947},"'-5'",[1948],{"type":628},{"text":1950,"type":333}," — subtracts 5",{"type":351,"content":1952},[1953],{"type":335,"attrs":1954,"content":1955},{"textAlign":59},[1956,1960],{"text":1957,"type":333,"marks":1958},"'*2'",[1959],{"type":628},{"text":1961,"type":333}," — multiplies by 2",{"type":351,"content":1963},[1964],{"type":335,"attrs":1965,"content":1966},{"textAlign":59},[1967,1971],{"text":1968,"type":333,"marks":1969},"'\u002F2'",[1970],{"type":628},{"text":1972,"type":333}," — divides by 2",{"type":351,"content":1974},[1975],{"type":335,"attrs":1976,"content":1977},{"textAlign":59},[1978,1982],{"text":1979,"type":333,"marks":1980},"'=15'",[1981],{"type":628},{"text":1983,"type":333}," — sets to exactly 15 (same as passing a number)",{"type":351,"content":1985},[1986],{"type":335,"attrs":1987,"content":1988},{"textAlign":59},[1989,1993],{"text":1990,"type":333,"marks":1991},"'+20%'",[1992],{"type":628},{"text":1994,"type":333}," — adds 20% of the current price",{"type":351,"content":1996},[1997],{"type":335,"attrs":1998,"content":1999},{"textAlign":59},[2000,2004],{"text":2001,"type":333,"marks":2002},"'-20%'",[2003],{"type":628},{"text":2005,"type":333}," — subtracts 20% of the current price",{"type":1726,"attrs":2007,"content":2008},{"class":59},[2009],{"text":2010,"type":333},"rates.filter('usps').price('+2.50');\nrates.filter(10001).price(0);\nrates.filter('fedex').price('-10%');",{"type":327,"attrs":2012,"content":2013},{"level":329,"textAlign":59},[2014],{"text":2015,"type":333},"Modifying labels",{"type":335,"attrs":2017,"content":2018},{"textAlign":59},[2019,2023],{"text":2020,"type":333,"marks":2021},"rates.method(string)",[2022],{"type":628},{"text":2024,"type":333}," — sets the carrier\u002Fmethod name for matched rates.",{"type":335,"attrs":2026,"content":2027},{"textAlign":59},[2028,2032],{"text":2029,"type":333,"marks":2030},"rates.service(string)",[2031],{"type":628},{"text":2033,"type":333}," — sets the service name for matched rates.",{"type":335,"attrs":2035,"content":2036},{"textAlign":59},[2037,2039,2043],{"text":2038,"type":333},"When called without an argument inside an ",{"text":2040,"type":333,"marks":2041},".each()",[2042],{"type":628},{"text":2044,"type":333}," callback, these return the current value.",{"type":1726,"attrs":2046,"content":2047},{"class":59},[2048],{"text":2049,"type":333},"rates.filter('usps').method('US Postal Service');\nrates.filter(10001).service('Economy');",{"type":335,"attrs":2051,"content":2052},{"textAlign":59},[2053],{"text":2054,"type":333},"Note: HTML in method or service strings is not currently supported.",{"type":327,"attrs":2056,"content":2057},{"level":329,"textAlign":59},[2058],{"text":2059,"type":333},"Iterating over rates",{"type":335,"attrs":2061,"content":2062},{"textAlign":59},[2063],{"text":2064,"type":333,"marks":2065},"rates.each(fn)",[2066],{"type":628},{"type":335,"attrs":2068,"content":2069},{"textAlign":59},[2070,2072,2076,2078,2082,2084,2088,2089,2093,2094,2098,2099,2103,2105,2109],{"text":2071,"type":333},"Calls ",{"text":2073,"type":333,"marks":2074},"fn",[2075],{"type":628},{"text":2077,"type":333}," for each matched rate. Inside the callback, ",{"text":2079,"type":333,"marks":2080},"this",[2081],{"type":628},{"text":2083,"type":333}," refers to the individual rate and exposes ",{"text":2085,"type":333,"marks":2086},".price()",[2087],{"type":628},{"text":636,"type":333},{"text":2090,"type":333,"marks":2091},".method()",[2092],{"type":628},{"text":636,"type":333},{"text":2095,"type":333,"marks":2096},".service()",[2097],{"type":628},{"text":636,"type":333},{"text":2100,"type":333,"marks":2101},".hide()",[2102],{"type":628},{"text":2104,"type":333},", and ",{"text":2106,"type":333,"marks":2107},".show()",[2108],{"type":628},{"text":390,"type":333},{"type":1726,"attrs":2111,"content":2112},{"class":59},[2113],{"text":2114,"type":333},"rates.filter('fedex').each(function() {\n  this.service(this.service() + ' (Signature Required)');\n});",{"type":327,"attrs":2116,"content":2117},{"level":329,"textAlign":59},[2118],{"text":2119,"type":333},"Sorting",{"type":335,"attrs":2121,"content":2122},{"textAlign":59},[2123],{"text":2124,"type":333,"marks":2125},"rates.sort()",[2126],{"type":628},{"type":335,"attrs":2128,"content":2129},{"textAlign":59},[2130],{"text":2131,"type":333},"Sorts matched rates by price (ascending). Note that Foxy always re sorts rates ascending for display regardless of your code's ordering, so this is mainly useful if you need sorted iteration.",{"type":327,"attrs":2133,"content":2134},{"level":329,"textAlign":59},[2135],{"text":2136,"type":333},"Handling fees and flat rates",{"type":335,"attrs":2138,"content":2139},{"textAlign":59},[2140,2142,2145],{"text":2141,"type":333},"Custom rates added via ",{"text":625,"type":333,"marks":2143},[2144],{"type":628},{"text":2146,"type":333}," do not automatically include handling fees or flat rates from other categories in the cart. These helpers let you add or remove them:",{"type":405,"content":2148},[2149,2159,2169,2179,2190,2201],{"type":351,"content":2150},[2151],{"type":335,"attrs":2152,"content":2153},{"textAlign":59},[2154,2157],{"text":632,"type":333,"marks":2155},[2156],{"type":628},{"text":2158,"type":333}," — adds handling fees from other categories to matched rates",{"type":351,"content":2160},[2161],{"type":335,"attrs":2162,"content":2163},{"textAlign":59},[2164,2167],{"text":638,"type":333,"marks":2165},[2166],{"type":628},{"text":2168,"type":333}," — adds flat rate fees from other categories",{"type":351,"content":2170},[2171],{"type":335,"attrs":2172,"content":2173},{"textAlign":59},[2174,2177],{"text":643,"type":333,"marks":2175},[2176],{"type":628},{"text":2178,"type":333}," — adds both",{"type":351,"content":2180},[2181],{"type":335,"attrs":2182,"content":2183},{"textAlign":59},[2184,2188],{"text":2185,"type":333,"marks":2186},"rates.removeHandling()",[2187],{"type":628},{"text":2189,"type":333}," — removes handling fees from matched rates",{"type":351,"content":2191},[2192],{"type":335,"attrs":2193,"content":2194},{"textAlign":59},[2195,2199],{"text":2196,"type":333,"marks":2197},"rates.removeFlatRate()",[2198],{"type":628},{"text":2200,"type":333}," — removes flat rate fees",{"type":351,"content":2202},[2203],{"type":335,"attrs":2204,"content":2205},{"textAlign":59},[2206,2210],{"text":2207,"type":333,"marks":2208},"rates.removeHandlingAndFlatRate()",[2209],{"type":628},{"text":2211,"type":333}," — removes both",{"type":327,"attrs":2213,"content":2214},{"level":329,"textAlign":59},[2215],{"text":2216,"type":333},"Errors and resets",{"type":335,"attrs":2218,"content":2219},{"textAlign":59},[2220,2224],{"text":2221,"type":333,"marks":2222},"rates.error(message)",[2223],{"type":628},{"text":2225,"type":333}," — sets an error message. If set, the error is displayed to the customer instead of any rates (error takes precedence).",{"type":335,"attrs":2227,"content":2228},{"textAlign":59},[2229,2233],{"text":2230,"type":333,"marks":2231},"rates.reset()",[2232],{"type":628},{"text":2234,"type":333}," — clears all rates and any error message.",{"type":327,"attrs":2236,"content":2237},{"level":329,"textAlign":59},[2238],{"text":2239,"type":333},"The cart object",{"type":335,"attrs":2241,"content":2242},{"textAlign":59},[2243,2244,2248],{"text":1390,"type":333},{"text":2245,"type":333,"marks":2246},"cart",[2247],{"type":628},{"text":2249,"type":333}," object available in Custom Shipping Code contains the same payload sent to the Custom Shipping Endpoint. See the [Shipping Payload Reference] for the full structure, field descriptions, and common access patterns.",{"id":59,"alt":59,"name":13,"focus":59,"title":59,"source":59,"filename":13,"copyright":59,"fieldtype":81,"meta_data":2251},{},"Complete reference for the rates JavaScript API available in Custom Shipping Code feature of the Foxy Admin.",[],"custom-shipping-code-api-reference","help\u002Farticles\u002Fcustom-shipping-code-api-reference",-1900,[],"e7481619-f7c8-4d46-9be9-42733b938287",[],[],[],{"name":2263,"created_at":2264,"published_at":2265,"updated_at":2266,"id":2267,"uuid":1141,"content":2268,"slug":2626,"full_slug":2627,"sort_by_date":59,"position":2628,"tag_list":2629,"is_startpage":24,"parent_id":824,"meta_data":59,"group_id":2630,"first_published_at":2631,"release_id":59,"lang":65,"path":59,"alternates":2632,"default_full_slug":59,"translated_slugs":59,"_stopResolving":33},"Product Categories Overview","2025-09-19T16:47:16.492Z","2025-10-01T00:34:35.870Z","2026-07-15T21:13:35.017Z",92613986323688,{"_uid":2269,"body":2270,"name":2263,"image":2362,"pinned":33,"summary":13,"category":2364,"component":266,"related_articles":2365},"fca5b55e-fe05-4e3c-a298-ac1b7ba3bc80",{"type":324,"content":2271},[2272,2276,2281,2292,2302,2312,2322,2332,2342,2352],{"type":327,"attrs":2273,"content":2274},{"level":329,"textAlign":59},[2275],{"text":332,"type":333},{"type":335,"attrs":2277,"content":2278},{"textAlign":59},[2279],{"text":2280,"type":333},"Product Categories offer a way to give products additional behaviors that cannot be accomplished by product options alone. Product Categories can be access in the Foxy admin by clicking on Categories in the navigation.",{"type":335,"attrs":2282,"content":2283},{"textAlign":59},[2284,2288,2290],{"text":2285,"type":333,"marks":2286},"Email Receipts",[2287],{"type":362},{"type":2289},"hard_break",{"text":2291,"type":333},"Email receipts can be generated on a per category basis, and different emails can be configured for customers and for admins. So, if you had a conference registration category but also sold books and CDs, you might want a transaction that included a conference registration to send an email to a store admin (the conference registrar); or to send an extra email to the customer with a schedule and link to the hotel; or to send both emails (as they can be configured independently).",{"type":335,"attrs":2293,"content":2294},{"textAlign":59},[2295,2299,2300],{"text":2296,"type":333,"marks":2297},"Default Weight Values",[2298],{"type":362},{"type":2289},{"text":2301,"type":333},"These default values can be overridden by explicitly setting the weight product option, but if you have a category for “Shirts” you could set the default weight to 0.5, while you have another category for “Paperweights” with a default weight of 3. That way you wouldn't have to explicitly set the weight on every product's add-to-cart link or form. The default for new stores is lbs. but this can be changed to kgs. in the category.",{"type":335,"attrs":2303,"content":2304},{"textAlign":59},[2305,2309,2310],{"text":2306,"type":333,"marks":2307},"Taxes",[2308],{"type":362},{"type":2289},{"text":2311,"type":333},"Taxes must be set at the category level. This allows you to have certain products taxed differently from others, which can be useful in a variety of situations.",{"type":335,"attrs":2313,"content":2314},{"textAlign":59},[2315,2319,2320],{"text":2316,"type":333,"marks":2317},"Shipping and Handling Fees",[2318],{"type":362},{"type":2289},{"text":2321,"type":333},"Categories can set specific handling fees, as well as shipping methods.",{"type":335,"attrs":2323,"content":2324},{"textAlign":59},[2325,2329,2330],{"text":2326,"type":333,"marks":2327},"Customs Values",[2328],{"type":362},{"type":2289},{"text":2331,"type":333},"Customs values (used in shipping calculations) can only be set at the category level.",{"type":335,"attrs":2333,"content":2334},{"textAlign":59},[2335,2339,2340],{"text":2336,"type":333,"marks":2337},"Quantity Discounts",[2338],{"type":362},{"type":2289},{"text":2341,"type":333},"While individual products can have quantity discounts, they can also be applied for all products in the cart in a given category.",{"type":335,"attrs":2343,"content":2344},{"textAlign":59},[2345,2349,2350],{"text":2346,"type":333,"marks":2347},"Coupon Codes",[2348],{"type":362},{"type":2289},{"text":2351,"type":333},"Coupons can be restricted per category, though this is done on the coupon code admin section, not the category admin section.",{"type":335,"attrs":2353,"content":2354},{"textAlign":59},[2355,2359,2360],{"text":2356,"type":333,"marks":2357},"Downloadables",[2358],{"type":362},{"type":2289},{"text":2361,"type":333},"Downloadable products must be added to a category where the shipping method is set to “Downloaded by the customer”.",{"id":59,"alt":59,"name":13,"focus":59,"title":59,"source":59,"filename":13,"copyright":59,"fieldtype":81,"meta_data":2363},{},"ba278b8f-1c99-4680-9133-03f2433e6116",[2366,2486,2551],{"name":2367,"created_at":2368,"published_at":2369,"updated_at":2370,"id":2371,"uuid":2372,"content":2373,"slug":2479,"full_slug":2480,"sort_by_date":59,"position":2481,"tag_list":2482,"is_startpage":24,"parent_id":824,"meta_data":59,"group_id":2483,"first_published_at":2484,"release_id":59,"lang":65,"path":59,"alternates":2485,"default_full_slug":59,"translated_slugs":59,"_stopResolving":33},"Create a new category","2025-09-19T18:04:00.004Z","2025-10-10T22:02:51.093Z","2025-10-10T22:02:51.106Z",92632842304230,"af46955a-a736-40ab-9c53-b823c6ef3141",{"_uid":2374,"body":2375,"name":2367,"image":2473,"pinned":24,"summary":2475,"category":2364,"component":266,"related_articles":2476},"0df53e06-6768-4474-ad2e-3d718d8ec359",{"type":324,"content":2376},[2377,2386],{"type":2378,"attrs":2379},"blok",{"id":2380,"body":2381},"5b994ef8-13ed-41d0-a633-7c31d5cc8fe6",[2382],{"url":2383,"_uid":2384,"component":2385},"https:\u002F\u002Fdemo.arcade.software\u002FeyNUq5NP0n7lzx92vM78?embed&embed_mobile=inline&embed_desktop=inline&show_copy_link=false","i-43bd5237-fb20-49d3-ac3c-7f6c76f7184c","global___embed",{"type":346,"attrs":2387,"content":2388},{"order":348},[2389,2408,2421,2433,2444,2456,2466],{"type":351,"content":2390},[2391],{"type":335,"attrs":2392,"content":2393},{"textAlign":59},[2394,2396,2401,2403,2406],{"text":2395,"type":333},"In the ",{"text":1164,"type":333,"marks":2397},[2398],{"type":617,"attrs":2399},{"href":2400,"uuid":59,"anchor":59,"target":621,"linktype":31},"http:\u002F\u002Fadmin.foxy.io\u002F",{"text":2402,"type":333},", click on ",{"text":359,"type":333,"marks":2404},[2405],{"type":362},{"text":2407,"type":333}," from the navigation.",{"type":351,"content":2409},[2410],{"type":335,"attrs":2411,"content":2412},{"textAlign":59},[2413,2415,2419],{"text":2414,"type":333},"At the top of the page click on the ",{"text":2416,"type":333,"marks":2417},"+",[2418],{"type":362},{"text":2420,"type":333}," icon.",{"type":351,"content":2422},[2423],{"type":335,"attrs":2424,"content":2425},{"textAlign":59},[2426,2428,2432],{"text":2427,"type":333},"Input a category ",{"text":2429,"type":333,"marks":2430},"Name",[2431],{"type":362},{"text":390,"type":333},{"type":351,"content":2434},[2435],{"type":335,"attrs":2436,"content":2437},{"textAlign":59},[2438,2439,2443],{"text":2427,"type":333},{"text":2440,"type":333,"marks":2441},"Code",[2442],{"type":362},{"text":390,"type":333},{"type":351,"content":2445},[2446],{"type":335,"attrs":2447,"content":2448},{"textAlign":59},[2449,2451,2455],{"text":2450,"type":333},"Select a ",{"text":2452,"type":333,"marks":2453},"Delivery type",[2454],{"type":362},{"text":390,"type":333},{"type":351,"content":2457},[2458],{"type":335,"attrs":2459,"content":2460},{"textAlign":59},[2461,2462,2465],{"text":2450,"type":333},{"text":399,"type":333,"marks":2463},[2464],{"type":362},{"text":390,"type":333},{"type":351,"content":2467},[2468],{"type":335,"attrs":2469,"content":2470},{"textAlign":59},[2471],{"text":2472,"type":333},"Save changes by clicking on the checkmark icon (located at top right of page).",{"id":59,"alt":59,"name":13,"focus":59,"title":59,"source":59,"filename":13,"copyright":59,"fieldtype":81,"meta_data":2474},{},"How to create a new category in the Foxy admin.",[2477,2478],"0c02ee7d-6942-48ea-bd77-c152013bd404","49fb898d-b270-485f-98b0-82a21073c8d0","create-a-new-category","help\u002Farticles\u002Fcreate-a-new-category",-1520,[],"433316a9-7ca6-4388-8530-05c0dd9228ef","2025-09-19T18:19:36.530Z",[],{"name":2487,"created_at":2488,"published_at":2489,"updated_at":2490,"id":2491,"uuid":2477,"content":2492,"slug":2544,"full_slug":2545,"sort_by_date":59,"position":2546,"tag_list":2547,"is_startpage":24,"parent_id":824,"meta_data":59,"group_id":2548,"first_published_at":2549,"release_id":59,"lang":65,"path":59,"alternates":2550,"default_full_slug":59,"translated_slugs":59,"_stopResolving":33},"Modify a category","2025-09-19T20:31:58.011Z","2025-10-10T22:02:51.593Z","2025-10-10T22:02:51.605Z",92669206620613,{"_uid":2374,"body":2493,"name":2487,"image":2540,"pinned":24,"summary":2542,"category":2364,"component":266,"related_articles":2543},{"type":324,"content":2494},[2495,2502],{"type":2378,"attrs":2496},{"id":2497,"body":2498},"5a3eea1b-d102-4b7a-a6c0-a1a29b95181d",[2499],{"url":2500,"_uid":2501,"component":2385},"https:\u002F\u002Fdemo.arcade.software\u002Ffbu07L8NZpK7KxP7sLFT?embed&embed_mobile=inline&embed_desktop=inline&show_copy_link=false","i-7349bc14-526a-4c7d-ab4b-e9b6ed7728cb",{"type":346,"attrs":2503,"content":2504},{"order":348},[2505,2520,2527,2534],{"type":351,"content":2506},[2507],{"type":335,"attrs":2508,"content":2509},{"textAlign":59},[2510,2511,2515,2516,2519],{"text":2395,"type":333},{"text":1164,"type":333,"marks":2512},[2513],{"type":617,"attrs":2514},{"href":2400,"uuid":59,"anchor":59,"target":621,"linktype":31},{"text":2402,"type":333},{"text":359,"type":333,"marks":2517},[2518],{"type":362},{"text":2407,"type":333},{"type":351,"content":2521},[2522],{"type":335,"attrs":2523,"content":2524},{"textAlign":59},[2525],{"text":2526,"type":333},"Click on desired category.",{"type":351,"content":2528},[2529],{"type":335,"attrs":2530,"content":2531},{"textAlign":59},[2532],{"text":2533,"type":333},"Make needed changes.",{"type":351,"content":2535},[2536],{"type":335,"attrs":2537,"content":2538},{"textAlign":59},[2539],{"text":2472,"type":333},{"id":59,"alt":59,"name":13,"focus":59,"title":59,"source":59,"filename":13,"copyright":59,"fieldtype":81,"meta_data":2541},{},"How to modify a category in the Foxy admin.",[2372,2478],"modify-a-category","help\u002Farticles\u002Fmodify-a-category",-1500,[],"f9a9583a-518e-4605-8789-cd8764ca2ad8","2025-09-19T20:37:43.265Z",[],{"name":2552,"created_at":2553,"published_at":2554,"updated_at":2555,"id":2556,"uuid":2478,"content":2557,"slug":2619,"full_slug":2620,"sort_by_date":59,"position":2621,"tag_list":2622,"is_startpage":24,"parent_id":824,"meta_data":59,"group_id":2623,"first_published_at":2624,"release_id":59,"lang":65,"path":59,"alternates":2625,"default_full_slug":59,"translated_slugs":59,"_stopResolving":33},"Delete a category","2025-09-19T20:17:27.352Z","2025-10-10T22:02:51.367Z","2025-10-10T22:02:51.380Z",92665640390750,{"_uid":2374,"body":2558,"name":2552,"image":2615,"pinned":24,"summary":2617,"category":2364,"component":266,"related_articles":2618},{"type":324,"content":2559},[2560,2567],{"type":2378,"attrs":2561},{"id":2562,"body":2563},"d7db5a1c-484e-426e-9456-c54d5c96fbbd",[2564],{"url":2565,"_uid":2566,"component":2385},"https:\u002F\u002Fdemo.arcade.software\u002Fe07NLAGGSwLiUHX7PwQq?embed&embed_mobile=inline&embed_desktop=inline&show_copy_link=false","i-c2d2d704-8c84-4908-9f12-20e47b54ff6d",{"type":346,"attrs":2568,"content":2569},{"order":348},[2570,2585,2591,2604],{"type":351,"content":2571},[2572],{"type":335,"attrs":2573,"content":2574},{"textAlign":59},[2575,2576,2580,2581,2584],{"text":2395,"type":333},{"text":1164,"type":333,"marks":2577},[2578],{"type":617,"attrs":2579},{"href":2400,"uuid":59,"anchor":59,"target":621,"linktype":31},{"text":2402,"type":333},{"text":359,"type":333,"marks":2582},[2583],{"type":362},{"text":2407,"type":333},{"type":351,"content":2586},[2587],{"type":335,"attrs":2588,"content":2589},{"textAlign":59},[2590],{"text":2526,"type":333},{"type":351,"content":2592},[2593],{"type":335,"attrs":2594,"content":2595},{"textAlign":59},[2596,2598,2602],{"text":2597,"type":333},"On the following page, click on the ",{"text":2599,"type":333,"marks":2600},"Delete",[2601],{"type":362},{"text":2603,"type":333}," button (located at bottom of page).",{"type":351,"content":2605},[2606],{"type":335,"attrs":2607,"content":2608},{"textAlign":59},[2609,2611,2614],{"text":2610,"type":333},"In the confirmation prompt, click on ",{"text":2599,"type":333,"marks":2612},[2613],{"type":362},{"text":390,"type":333},{"id":59,"alt":59,"name":13,"focus":59,"title":59,"source":59,"filename":13,"copyright":59,"fieldtype":81,"meta_data":2616},{},"How to delete a category in the Foxy admin.",[2372,2477],"delete-a-category","help\u002Farticles\u002Fdelete-a-category",-1510,[],"4eb3ca65-8120-4687-8508-b74ea5a02863","2025-09-19T20:25:49.896Z",[],"product-categories-overview","help\u002Farticles\u002Fproduct-categories-overview",-1490,[],"7847b29a-f3f5-4a5d-a0ac-6f2006e6ec10","2025-09-19T18:19:37.011Z",[],{"name":686,"created_at":829,"published_at":830,"updated_at":831,"id":832,"uuid":815,"content":2634,"slug":1605,"full_slug":1606,"sort_by_date":59,"position":1607,"tag_list":3276,"is_startpage":24,"parent_id":824,"meta_data":59,"group_id":1609,"first_published_at":1610,"release_id":59,"lang":65,"path":59,"alternates":3277,"default_full_slug":59,"translated_slugs":59,"_stopResolving":33},{"_uid":834,"body":2635,"name":686,"image":2768,"pinned":24,"summary":995,"category":813,"component":266,"related_articles":2770},{"type":324,"content":2636},[2637,2641,2645,2665,2669,2675,2679,2726,2732,2736,2740,2760,2764],{"type":327,"attrs":2638,"content":2639},{"level":329,"textAlign":59},[2640],{"text":332,"type":333},{"type":335,"attrs":2642,"content":2643},{"textAlign":59},[2644],{"text":845,"type":333},{"type":405,"content":2646},[2647,2656],{"type":351,"content":2648},[2649],{"type":335,"attrs":2650,"content":2651},{"textAlign":59},[2652,2655],{"text":854,"type":333,"marks":2653},[2654],{"type":362},{"text":858,"type":333},{"type":351,"content":2657},[2658],{"type":335,"attrs":2659,"content":2660},{"textAlign":59},[2661,2664],{"text":865,"type":333,"marks":2662},[2663],{"type":362},{"text":869,"type":333},{"type":335,"attrs":2666,"content":2667},{"textAlign":59},[2668],{"text":874,"type":333},{"type":327,"attrs":2670,"content":2671},{"level":329,"textAlign":59},[2672],{"text":879,"type":333,"marks":2673},[2674],{"type":362},{"type":335,"attrs":2676,"content":2677},{"textAlign":59},[2678],{"text":886,"type":333},{"type":405,"content":2680},[2681,2690,2699,2708,2717],{"type":351,"content":2682},[2683],{"type":335,"attrs":2684,"content":2685},{"textAlign":59},[2686,2689],{"text":895,"type":333,"marks":2687},[2688],{"type":362},{"text":899,"type":333},{"type":351,"content":2691},[2692],{"type":335,"attrs":2693,"content":2694},{"textAlign":59},[2695,2698],{"text":906,"type":333,"marks":2696},[2697],{"type":362},{"text":910,"type":333},{"type":351,"content":2700},[2701],{"type":335,"attrs":2702,"content":2703},{"textAlign":59},[2704,2707],{"text":751,"type":333,"marks":2705},[2706],{"type":362},{"text":920,"type":333},{"type":351,"content":2709},[2710],{"type":335,"attrs":2711,"content":2712},{"textAlign":59},[2713,2716],{"text":927,"type":333,"marks":2714},[2715],{"type":362},{"text":931,"type":333},{"type":351,"content":2718},[2719],{"type":335,"attrs":2720,"content":2721},{"textAlign":59},[2722,2725],{"text":938,"type":333,"marks":2723},[2724],{"type":362},{"text":942,"type":333},{"type":327,"attrs":2727,"content":2728},{"level":329,"textAlign":59},[2729],{"text":947,"type":333,"marks":2730},[2731],{"type":362},{"type":335,"attrs":2733,"content":2734},{"textAlign":59},[2735],{"text":954,"type":333},{"type":335,"attrs":2737,"content":2738},{"textAlign":59},[2739],{"text":959,"type":333},{"type":405,"content":2741},[2742,2748,2754],{"type":351,"content":2743},[2744],{"type":335,"attrs":2745,"content":2746},{"textAlign":59},[2747],{"text":968,"type":333},{"type":351,"content":2749},[2750],{"type":335,"attrs":2751,"content":2752},{"textAlign":59},[2753],{"text":975,"type":333},{"type":351,"content":2755},[2756],{"type":335,"attrs":2757,"content":2758},{"textAlign":59},[2759],{"text":982,"type":333},{"type":335,"attrs":2761,"content":2762},{"textAlign":59},[2763],{"text":987,"type":333},{"type":335,"attrs":2765,"content":2766},{"textAlign":59},[2767],{"text":992,"type":333},{"id":59,"alt":59,"name":13,"focus":59,"title":59,"source":59,"filename":13,"copyright":59,"fieldtype":81,"meta_data":2769},{},[2771,2890,3117,3221],{"name":659,"created_at":660,"published_at":661,"updated_at":662,"id":663,"uuid":664,"content":2772,"slug":820,"full_slug":821,"sort_by_date":59,"position":822,"tag_list":2888,"is_startpage":24,"parent_id":824,"meta_data":59,"group_id":825,"first_published_at":826,"release_id":59,"lang":65,"path":59,"alternates":2889,"default_full_slug":59,"translated_slugs":59,"_stopResolving":33},{"_uid":666,"body":2773,"name":659,"image":2885,"pinned":24,"summary":812,"category":813,"component":266,"related_articles":2887},{"type":324,"content":2774},[2775,2781,2785,2794,2798,2863,2867,2881],{"type":327,"attrs":2776,"content":2777},{"level":329,"textAlign":59},[2778],{"text":332,"type":333,"marks":2779},[2780],{"type":362},{"type":335,"attrs":2782,"content":2783},{"textAlign":59},[2784],{"text":679,"type":333},{"type":335,"attrs":2786,"content":2787},{"textAlign":59},[2788,2789,2793],{"text":684,"type":333},{"text":686,"type":333,"marks":2790},[2791],{"type":617,"attrs":2792},{"href":690,"uuid":691,"anchor":59,"target":621,"linktype":14},{"text":693,"type":333},{"type":335,"attrs":2795,"content":2796},{"textAlign":59},[2797],{"text":698,"type":333},{"type":405,"content":2799},[2800,2809,2818,2827,2836,2845,2854],{"type":351,"content":2801},[2802],{"type":335,"attrs":2803,"content":2804},{"textAlign":59},[2805,2808],{"text":707,"type":333,"marks":2806},[2807],{"type":362},{"text":711,"type":333},{"type":351,"content":2810},[2811],{"type":335,"attrs":2812,"content":2813},{"textAlign":59},[2814,2817],{"text":718,"type":333,"marks":2815},[2816],{"type":362},{"text":722,"type":333},{"type":351,"content":2819},[2820],{"type":335,"attrs":2821,"content":2822},{"textAlign":59},[2823,2826],{"text":729,"type":333,"marks":2824},[2825],{"type":362},{"text":733,"type":333},{"type":351,"content":2828},[2829],{"type":335,"attrs":2830,"content":2831},{"textAlign":59},[2832,2835],{"text":740,"type":333,"marks":2833},[2834],{"type":362},{"text":744,"type":333},{"type":351,"content":2837},[2838],{"type":335,"attrs":2839,"content":2840},{"textAlign":59},[2841,2844],{"text":751,"type":333,"marks":2842},[2843],{"type":362},{"text":755,"type":333},{"type":351,"content":2846},[2847],{"type":335,"attrs":2848,"content":2849},{"textAlign":59},[2850,2853],{"text":762,"type":333,"marks":2851},[2852],{"type":362},{"text":766,"type":333},{"type":351,"content":2855},[2856],{"type":335,"attrs":2857,"content":2858},{"textAlign":59},[2859,2862],{"text":773,"type":333,"marks":2860},[2861],{"type":362},{"text":777,"type":333},{"type":335,"attrs":2864,"content":2865},{"textAlign":59},[2866],{"text":782,"type":333},{"type":335,"attrs":2868,"content":2869},{"textAlign":59},[2870,2871,2875,2876,2880],{"text":787,"type":333},{"text":614,"type":333,"marks":2872},[2873],{"type":617,"attrs":2874},{"href":792,"uuid":793,"anchor":59,"target":621,"linktype":14},{"text":795,"type":333},{"text":797,"type":333,"marks":2877},[2878],{"type":617,"attrs":2879},{"href":801,"uuid":802,"anchor":59,"target":621,"linktype":14},{"text":804,"type":333},{"type":335,"attrs":2882,"content":2883},{"textAlign":59},[2884],{"text":809,"type":333},{"id":59,"alt":59,"name":13,"focus":59,"title":59,"source":59,"filename":13,"copyright":59,"fieldtype":81,"meta_data":2886},{},[815,816,817,818,620,525,819],[],[],{"name":1117,"created_at":1118,"published_at":1119,"updated_at":1120,"id":1121,"uuid":816,"content":2891,"slug":1409,"full_slug":1410,"sort_by_date":59,"position":1411,"tag_list":3115,"is_startpage":24,"parent_id":824,"meta_data":59,"group_id":1413,"first_published_at":1119,"release_id":59,"lang":65,"path":59,"alternates":3116,"default_full_slug":59,"translated_slugs":59,"_stopResolving":33},{"_uid":1123,"body":2892,"name":1117,"image":3112,"pinned":24,"summary":1405,"category":1406,"component":266,"related_articles":3114},{"type":324,"content":2893},[2894,2898,2907,2914,2918,2927,2974,2978,2984,2988,2994,2998,3002,3011,3017,3021,3025,3029,3058,3074,3078,3082,3086,3090,3094,3098],{"type":327,"attrs":2895,"content":2896},{"level":329,"textAlign":59},[2897],{"text":332,"type":333},{"type":335,"attrs":2899,"content":2900},{"textAlign":59},[2901,2902,2906],{"text":1134,"type":333},{"text":1136,"type":333,"marks":2903},[2904],{"type":617,"attrs":2905},{"href":1140,"uuid":1141,"anchor":59,"target":621,"linktype":14},{"text":1143,"type":333},{"type":335,"attrs":2908,"content":2909},{"textAlign":59},[2910,2913],{"text":1148,"type":333,"marks":2911},[2912],{"type":362},{"text":1152,"type":333},{"type":327,"attrs":2915,"content":2916},{"level":329,"textAlign":59},[2917],{"text":1157,"type":333},{"type":335,"attrs":2919,"content":2920},{"textAlign":59},[2921,2922,2926],{"text":1162,"type":333},{"text":1164,"type":333,"marks":2923},[2924],{"type":617,"attrs":2925},{"href":1168,"uuid":59,"anchor":59,"target":621,"linktype":31},{"text":1170,"type":333},{"type":405,"content":2928},[2929,2938,2947,2956,2965],{"type":351,"content":2930},[2931],{"type":335,"attrs":2932,"content":2933},{"textAlign":59},[2934,2937],{"text":1179,"type":333,"marks":2935},[2936],{"type":362},{"text":1183,"type":333},{"type":351,"content":2939},[2940],{"type":335,"attrs":2941,"content":2942},{"textAlign":59},[2943,2946],{"text":1190,"type":333,"marks":2944},[2945],{"type":362},{"text":1194,"type":333},{"type":351,"content":2948},[2949],{"type":335,"attrs":2950,"content":2951},{"textAlign":59},[2952,2955],{"text":1201,"type":333,"marks":2953},[2954],{"type":362},{"text":1205,"type":333},{"type":351,"content":2957},[2958],{"type":335,"attrs":2959,"content":2960},{"textAlign":59},[2961,2964],{"text":1212,"type":333,"marks":2962},[2963],{"type":362},{"text":1216,"type":333},{"type":351,"content":2966},[2967],{"type":335,"attrs":2968,"content":2969},{"textAlign":59},[2970,2973],{"text":1223,"type":333,"marks":2971},[2972],{"type":362},{"text":1227,"type":333},{"type":327,"attrs":2975,"content":2976},{"level":329,"textAlign":59},[2977],{"text":1232,"type":333},{"type":327,"attrs":2979,"content":2980},{"level":1235,"textAlign":59},[2981],{"text":1238,"type":333,"marks":2982},[2983],{"type":362},{"type":335,"attrs":2985,"content":2986},{"textAlign":59},[2987],{"text":1245,"type":333},{"type":327,"attrs":2989,"content":2990},{"level":1235,"textAlign":59},[2991],{"text":1250,"type":333,"marks":2992},[2993],{"type":362},{"type":335,"attrs":2995,"content":2996},{"textAlign":59},[2997],{"text":1257,"type":333},{"type":335,"attrs":2999,"content":3000},{"textAlign":59},[3001],{"text":1262,"type":333},{"type":335,"attrs":3003,"content":3004},{"textAlign":59},[3005,3006,3010],{"text":1267,"type":333},{"text":1269,"type":333,"marks":3007},[3008],{"type":617,"attrs":3009},{"href":1273,"uuid":59,"anchor":59,"target":621,"linktype":31},{"text":1275,"type":333},{"type":327,"attrs":3012,"content":3013},{"level":1235,"textAlign":59},[3014],{"text":1280,"type":333,"marks":3015},[3016],{"type":362},{"type":335,"attrs":3018,"content":3019},{"textAlign":59},[3020],{"text":1287,"type":333},{"type":327,"attrs":3022,"content":3023},{"level":329,"textAlign":59},[3024],{"text":1292,"type":333},{"type":335,"attrs":3026,"content":3027},{"textAlign":59},[3028],{"text":1297,"type":333},{"type":405,"content":3030},[3031,3040,3049],{"type":351,"content":3032},[3033],{"type":335,"attrs":3034,"content":3035},{"textAlign":59},[3036,3039],{"text":1306,"type":333,"marks":3037},[3038],{"type":362},{"text":1310,"type":333},{"type":351,"content":3041},[3042],{"type":335,"attrs":3043,"content":3044},{"textAlign":59},[3045,3048],{"text":1317,"type":333,"marks":3046},[3047],{"type":362},{"text":1321,"type":333},{"type":351,"content":3050},[3051],{"type":335,"attrs":3052,"content":3053},{"textAlign":59},[3054,3057],{"text":1328,"type":333,"marks":3055},[3056],{"type":362},{"text":1332,"type":333},{"type":335,"attrs":3059,"content":3060},{"textAlign":59},[3061,3062,3065,3066,3069,3070,3073],{"text":1337,"type":333},{"text":1339,"type":333,"marks":3063},[3064],{"type":628},{"text":1343,"type":333},{"text":1345,"type":333,"marks":3067},[3068],{"type":628},{"text":1349,"type":333},{"text":1351,"type":333,"marks":3071},[3072],{"type":628},{"text":1355,"type":333},{"type":327,"attrs":3075,"content":3076},{"level":329,"textAlign":59},[3077],{"text":1360,"type":333},{"type":335,"attrs":3079,"content":3080},{"textAlign":59},[3081],{"text":1365,"type":333},{"type":335,"attrs":3083,"content":3084},{"textAlign":59},[3085],{"text":1370,"type":333},{"type":335,"attrs":3087,"content":3088},{"textAlign":59},[3089],{"text":1375,"type":333},{"type":335,"attrs":3091,"content":3092},{"textAlign":59},[3093],{"text":1380,"type":333},{"type":327,"attrs":3095,"content":3096},{"level":329,"textAlign":59},[3097],{"text":1385,"type":333},{"type":335,"attrs":3099,"content":3100},{"textAlign":59},[3101,3102,3106,3107,3111],{"text":1390,"type":333},{"text":614,"type":333,"marks":3103},[3104],{"type":617,"attrs":3105},{"href":619,"uuid":620,"anchor":59,"target":621,"linktype":14},{"text":795,"type":333},{"text":797,"type":333,"marks":3108},[3109],{"type":617,"attrs":3110},{"href":1400,"uuid":819,"anchor":59,"target":621,"linktype":14},{"text":1402,"type":333},{"id":59,"alt":59,"name":13,"focus":59,"title":59,"source":59,"filename":13,"copyright":59,"fieldtype":81,"meta_data":3113},{},[664,815,1408,620,819],[],[],{"name":520,"created_at":521,"published_at":522,"updated_at":523,"id":524,"uuid":525,"content":3118,"slug":1518,"full_slug":1519,"sort_by_date":59,"position":1520,"tag_list":3219,"is_startpage":24,"parent_id":824,"meta_data":59,"group_id":1522,"first_published_at":522,"release_id":59,"lang":65,"path":59,"alternates":3220,"default_full_slug":59,"translated_slugs":59,"_stopResolving":33},{"_uid":527,"body":3119,"name":520,"image":3216,"pinned":24,"summary":656,"category":517,"component":266,"related_articles":3218},{"type":324,"content":3120},[3121,3125,3129,3133,3137,3175,3179,3183,3187],{"type":327,"attrs":3122,"content":3123},{"level":329,"textAlign":59},[3124],{"text":332,"type":333},{"type":335,"attrs":3126,"content":3127},{"textAlign":59},[3128],{"text":538,"type":333},{"type":327,"attrs":3130,"content":3131},{"level":329,"textAlign":59},[3132],{"text":543,"type":333},{"type":335,"attrs":3134,"content":3135},{"textAlign":59},[3136],{"text":548,"type":333},{"type":405,"content":3138},[3139,3148,3157,3166],{"type":351,"content":3140},[3141],{"type":335,"attrs":3142,"content":3143},{"textAlign":59},[3144,3147],{"text":424,"type":333,"marks":3145},[3146],{"type":362},{"text":560,"type":333},{"type":351,"content":3149},[3150],{"type":335,"attrs":3151,"content":3152},{"textAlign":59},[3153,3156],{"text":435,"type":333,"marks":3154},[3155],{"type":362},{"text":570,"type":333},{"type":351,"content":3158},[3159],{"type":335,"attrs":3160,"content":3161},{"textAlign":59},[3162,3165],{"text":577,"type":333,"marks":3163},[3164],{"type":362},{"text":581,"type":333},{"type":351,"content":3167},[3168],{"type":335,"attrs":3169,"content":3170},{"textAlign":59},[3171,3174],{"text":588,"type":333,"marks":3172},[3173],{"type":362},{"text":592,"type":333},{"type":327,"attrs":3176,"content":3177},{"level":329,"textAlign":59},[3178],{"text":597,"type":333},{"type":335,"attrs":3180,"content":3181},{"textAlign":59},[3182],{"text":602,"type":333},{"type":327,"attrs":3184,"content":3185},{"level":329,"textAlign":59},[3186],{"text":607,"type":333},{"type":335,"attrs":3188,"content":3189},{"textAlign":59},[3190,3191,3195,3196,3199,3200,3203,3204,3207,3208,3211,3212,3215],{"text":612,"type":333},{"text":614,"type":333,"marks":3192},[3193],{"type":617,"attrs":3194},{"href":619,"uuid":620,"anchor":59,"target":621,"linktype":14},{"text":623,"type":333},{"text":625,"type":333,"marks":3197},[3198],{"type":628},{"text":630,"type":333},{"text":632,"type":333,"marks":3201},[3202],{"type":628},{"text":636,"type":333},{"text":638,"type":333,"marks":3205},[3206],{"type":628},{"text":636,"type":333},{"text":643,"type":333,"marks":3209},[3210],{"type":628},{"text":647,"type":333},{"text":649,"type":333,"marks":3213},[3214],{"type":628},{"text":653,"type":333},{"id":59,"alt":59,"name":13,"focus":59,"title":59,"source":59,"filename":13,"copyright":59,"fieldtype":81,"meta_data":3217},{},[664,815,818,1517],[],[],{"name":1525,"created_at":1526,"published_at":1527,"updated_at":1528,"id":1529,"uuid":818,"content":3222,"slug":1599,"full_slug":1600,"sort_by_date":59,"position":1601,"tag_list":3274,"is_startpage":24,"parent_id":824,"meta_data":59,"group_id":1603,"first_published_at":1527,"release_id":59,"lang":65,"path":59,"alternates":3275,"default_full_slug":59,"translated_slugs":59,"_stopResolving":33},{"_uid":1531,"body":3223,"name":1525,"image":3271,"pinned":24,"summary":1596,"category":1597,"component":266,"related_articles":3273},{"type":324,"content":3224},[3225,3229,3233,3237,3241,3245,3249,3253,3257],{"type":327,"attrs":3226,"content":3227},{"level":329,"textAlign":59},[3228],{"text":332,"type":333},{"type":335,"attrs":3230,"content":3231},{"textAlign":59},[3232],{"text":1542,"type":333},{"type":327,"attrs":3234,"content":3235},{"level":329,"textAlign":59},[3236],{"text":1547,"type":333},{"type":335,"attrs":3238,"content":3239},{"textAlign":59},[3240],{"text":1552,"type":333},{"type":327,"attrs":3242,"content":3243},{"level":329,"textAlign":59},[3244],{"text":1557,"type":333},{"type":335,"attrs":3246,"content":3247},{"textAlign":59},[3248],{"text":1562,"type":333},{"type":335,"attrs":3250,"content":3251},{"textAlign":59},[3252],{"text":1567,"type":333},{"type":327,"attrs":3254,"content":3255},{"level":329,"textAlign":59},[3256],{"text":1572,"type":333},{"type":335,"attrs":3258,"content":3259},{"textAlign":59},[3260,3261,3265,3266,3270],{"text":1577,"type":333},{"text":1579,"type":333,"marks":3262},[3263],{"type":617,"attrs":3264},{"href":1583,"uuid":1584,"anchor":59,"target":621,"linktype":14},{"text":1349,"type":333},{"text":1587,"type":333,"marks":3267},[3268],{"type":617,"attrs":3269},{"href":1591,"uuid":793,"anchor":59,"target":621,"linktype":14},{"text":1593,"type":333},{"id":59,"alt":59,"name":13,"focus":59,"title":59,"source":59,"filename":13,"copyright":59,"fieldtype":81,"meta_data":3272},{},[664,815,525,620],[],[],[],[],"add-a-handling-fee-to-a-category","help\u002Farticles\u002Fadd-a-handling-fee-to-a-category",-1970,[],"6ee4099b-1e6e-49f4-ba6e-9f8af4148b20",[],{"html":3285,"sections":3286,"segments":3296},"\u003Csection id=\"overview\" data-title=\"Overview\" data-title-node=\"H2\">\u003Chr class=\"my-8\" style=\"margin-left: -48px; margin-right: -40vw\">\u003Ch2 data-anchor-id=\"overview\">Overview\u003C\u002Fh2>\u003Cp>This article walks through adding a handling fee to a category. Handling fees are configured per category and are added on top of other shipping costs. For the calculation methods and how fees combine, see [Handling Fees].\u003C\u002Fp>\u003C\u002Fsection>\u003Csection id=\"steps\" data-title=\"Steps\" data-title-node=\"H2\">\u003Chr class=\"my-8\" style=\"margin-left: -48px; margin-right: -40vw\">\u003Ch2 data-anchor-id=\"steps\">Steps\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>In the Foxy admin, open the \u003Cstrong>Categories\u003C\u002Fstrong> section.\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>Select the category you want to configure.\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\">3\u003C\u002Fspan>\u003Cdiv class=\"w-100 overflow-hidden\">\u003Cdiv class=\"step-content mt-2\">\u003Cp>In \u003Cstrong>Category details\u003C\u002Fstrong>, scroll to \u003Cstrong>Handling Fees and Discounts\u003C\u002Fstrong>.\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\">4\u003C\u002Fspan>\u003Cdiv class=\"w-100 overflow-hidden\">\u003Cdiv class=\"step-content mt-2\">\u003Cp>Set \u003Cstrong>Handling fee type\u003C\u002Fstrong> to one of:\u003C\u002Fp>\u003Cul>\u003Cli>\u003Cp>\u003Cstrong>No handling fee\u003C\u002Fstrong> — no fee applied.\u003C\u002Fp>\u003C\u002Fli>\u003Cli>\u003Cp>\u003Cstrong>Flat fee per shipment\u003C\u002Fstrong> — a single fee when the cart contains products from this category.\u003C\u002Fp>\u003C\u002Fli>\u003Cli>\u003Cp>\u003Cstrong>Flat fee per product\u003C\u002Fstrong> — a fee multiplied by the quantity of items from this category.\u003C\u002Fp>\u003C\u002Fli>\u003Cli>\u003Cp>\u003Cstrong>Flat fee per shipment + % of price\u003C\u002Fstrong> — a flat fee plus a percentage of the category's item price.\u003C\u002Fp>\u003C\u002Fli>\u003Cli>\u003Cp>\u003Cstrong>Flat fee per shipment or % of price, whichever is greater\u003C\u002Fstrong> — Foxy applies the higher of the two.\u003C\u002Fp>\u003C\u002Fli>\u003C\u002Ful>\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\">5\u003C\u002Fspan>\u003Cdiv class=\"w-100 overflow-hidden\">\u003Cdiv class=\"step-content mt-2\">\u003Cp>Enter the \u003Cstrong>Handling fee amount\u003C\u002Fstrong> (the flat portion).\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\">6\u003C\u002Fspan>\u003Cdiv class=\"w-100 overflow-hidden\">\u003Cdiv class=\"step-content mt-2\">\u003Cp>If you chose a percentage based type, enter the \u003Cstrong>Percentage of price\u003C\u002Fstrong>.\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\">7\u003C\u002Fspan>\u003Cdiv class=\"w-100 overflow-hidden\">\u003Cdiv class=\"step-content mt-2\">\u003Cp>Save the category (the checkmark button at the top).\u003C\u002Fp>\u003C\u002Fdiv>\u003C\u002Fdiv>\u003C\u002Fdiv>\u003C\u002Fli>\u003C\u002Fol>\u003C\u002Fsection>\u003Csection id=\"note\" data-title=\"Note\" data-title-node=\"H2\">\u003Chr class=\"my-8\" style=\"margin-left: -48px; margin-right: -40vw\">\u003Ch2 data-anchor-id=\"note\">Note\u003C\u002Fh2>\u003Cp>Handling fees do not apply to categories set to "no shipping." They combine with live rates and flat rates from other categories and are folded into the total shipping cost shown at checkout (not displayed as a separate line item).\u003C\u002Fp>\u003C\u002Fsection>\u003Csection id=\"test-it\" data-title=\"Test it\" data-title-node=\"H2\">\u003Chr class=\"my-8\" style=\"margin-left: -48px; margin-right: -40vw\">\u003Ch2 data-anchor-id=\"test-it\">Test it\u003C\u002Fh2>\u003Cp>Add a product from this category to your cart and proceed to checkout. The handling fee should be included in the shipping total.\u003C\u002Fp>\u003C\u002Fsection>",[3287,3290,3292,3294],{"id":3288,"title":332,"level":3289},"overview","H2",{"id":3291,"title":344,"level":3289},"steps",{"id":3293,"title":498,"level":3289},"note",{"id":3295,"title":508,"level":3289},"test-it",[3297],{"type":3298,"content":3299},"html","\u003Ch2>Overview\u003C\u002Fh2>\u003Cp>This article walks through adding a handling fee to a category. Handling fees are configured per category and are added on top of other shipping costs. For the calculation methods and how fees combine, see [Handling Fees].\u003C\u002Fp>\u003Ch2>Steps\u003C\u002Fh2>\u003Col order=\"1\">\u003Cli>\u003Cp>In the Foxy admin, open the \u003Cstrong>Categories\u003C\u002Fstrong> section.\u003C\u002Fp>\u003C\u002Fli>\u003Cli>\u003Cp>Select the category you want to configure.\u003C\u002Fp>\u003C\u002Fli>\u003Cli>\u003Cp>In \u003Cstrong>Category details\u003C\u002Fstrong>, scroll to \u003Cstrong>Handling Fees and Discounts\u003C\u002Fstrong>.\u003C\u002Fp>\u003C\u002Fli>\u003Cli>\u003Cp>Set \u003Cstrong>Handling fee type\u003C\u002Fstrong> to one of:\u003C\u002Fp>\u003Cul>\u003Cli>\u003Cp>\u003Cstrong>No handling fee\u003C\u002Fstrong> — no fee applied.\u003C\u002Fp>\u003C\u002Fli>\u003Cli>\u003Cp>\u003Cstrong>Flat fee per shipment\u003C\u002Fstrong> — a single fee when the cart contains products from this category.\u003C\u002Fp>\u003C\u002Fli>\u003Cli>\u003Cp>\u003Cstrong>Flat fee per product\u003C\u002Fstrong> — a fee multiplied by the quantity of items from this category.\u003C\u002Fp>\u003C\u002Fli>\u003Cli>\u003Cp>\u003Cstrong>Flat fee per shipment + % of price\u003C\u002Fstrong> — a flat fee plus a percentage of the category's item price.\u003C\u002Fp>\u003C\u002Fli>\u003Cli>\u003Cp>\u003Cstrong>Flat fee per shipment or % of price, whichever is greater\u003C\u002Fstrong> — Foxy applies the higher of the two.\u003C\u002Fp>\u003C\u002Fli>\u003C\u002Ful>\u003C\u002Fli>\u003Cli>\u003Cp>Enter the \u003Cstrong>Handling fee amount\u003C\u002Fstrong> (the flat portion).\u003C\u002Fp>\u003C\u002Fli>\u003Cli>\u003Cp>If you chose a percentage based type, enter the \u003Cstrong>Percentage of price\u003C\u002Fstrong>.\u003C\u002Fp>\u003C\u002Fli>\u003Cli>\u003Cp>Save the category (the checkmark button at the top).\u003C\u002Fp>\u003C\u002Fli>\u003C\u002Fol>\u003Ch2>Note\u003C\u002Fh2>\u003Cp>Handling fees do not apply to categories set to "no shipping." They combine with live rates and flat rates from other categories and are folded into the total shipping cost shown at checkout (not displayed as a separate line item).\u003C\u002Fp>\u003Ch2>Test it\u003C\u002Fh2>\u003Cp>Add a product from this category to your cart and proceed to checkout. The handling fee should be included in the shipping total.\u003C\u002Fp>",{"name":3301,"created_at":3302,"published_at":3303,"updated_at":3304,"id":3305,"uuid":47,"content":3306,"slug":48,"full_slug":48,"sort_by_date":59,"position":3482,"tag_list":3483,"is_startpage":24,"parent_id":59,"meta_data":59,"group_id":3484,"first_published_at":3485,"release_id":59,"lang":65,"path":59,"alternates":3486,"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":3307,"_uid":3310,"title":3311,"action":3312,"fields":3313,"method":3458,"columns":3459,"subtitle":3473,"component":48,"button_text":3479,"submit_title":3480,"submit_subtitle":3481},{"_uid":3308,"title":3301,"plugin":3309,"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",[3314,3318,3322,3429,3432,3437,3452],{"_uid":3315,"name":3316,"type":333,"label":2429,"options":13,"required":33,"component":3317,"placeholder":13},"9a70b226-2036-4f90-a052-b3efa61c5896","name","form___field",{"_uid":3319,"name":3320,"type":3320,"label":3321,"options":13,"required":33,"component":3317,"placeholder":13},"86ba35be-ff43-4a28-8633-14052a8f6622","email","Email Address",{"_uid":3323,"name":3324,"type":3325,"label":3326,"options":3327,"required":33,"component":3317,"conditions":3328,"placeholder":13},"3f827475-492c-4f97-aa1e-2386ac263b6c","topic","select","Topic","Presales, Support, Billing, Partnerships, Order Enquiry, Other",[3329,3383,3393,3400,3408,3416,3422],{"_uid":3330,"equals":3331,"fields":3332,"component":3382},"e21d97dd-e68e-4fa6-ba97-bc40f3041dde","Order Enquiry",[3333],{"_uid":3334,"body":3335,"type":3380,"title":13,"component":3381},"b64992bc-6d53-48b8-b7a0-d81e5a062e50",{"type":324,"content":3336},[3337],{"type":335,"content":3338},[3339,3341,3348,3350,3351,3352,3356,3358,3363,3371,3373,3378],{"text":3340,"type":333},"We are ",{"text":3342,"type":333,"marks":3343},"Foxy.io",[3344],{"type":617,"attrs":3345},{"href":3346,"uuid":59,"anchor":59,"custom":3347,"target":59,"linktype":31},"http:\u002F\u002FFoxy.io",{},{"text":3349,"type":333},", 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":2289},{"type":2289},{"text":3353,"type":333,"marks":3354},"NOTE:",[3355],{"type":362},{"text":3357,"type":333}," We are ",{"text":3359,"type":333,"marks":3360},"not ",[3361],{"type":3362},"italic",{"text":3364,"type":333,"marks":3365},"Foxy.in",[3366,3370],{"type":617,"attrs":3367},{"href":3368,"uuid":59,"anchor":59,"custom":3369,"target":59,"linktype":31},"http:\u002F\u002FFoxy.in",{},{"type":3362},{"text":3372,"type":333},". We are not in any way affiliated with ",{"text":3364,"type":333,"marks":3374},[3375],{"type":617,"attrs":3376},{"href":3368,"uuid":59,"anchor":59,"custom":3377,"target":59,"linktype":31},{},{"text":3379,"type":333},", and cannot help in any way with your order from that website.","danger","global___alert","form___condition",{"_uid":3384,"equals":3385,"fields":3386,"component":3382},"8765c3e1-25cf-44aa-b8ea-fc6094acf9c3","Presales",[3387],{"_uid":3388,"name":3389,"type":3390,"label":13,"options":13,"required":24,"component":3317,"conditions":3391,"placeholder":13,"default_value":3392},"cf464f8e-d643-4f6e-af29-d3abffaf7380","department_email_address","hidden",[],"hello@foxy.io",{"_uid":3394,"equals":208,"fields":3395,"component":3382},"4007b6d8-77e5-421d-bd1e-6f336dd853fb",[3396],{"_uid":3397,"name":3389,"type":3390,"label":13,"options":13,"required":24,"component":3317,"conditions":3398,"placeholder":13,"default_value":3399},"7b4c6aa5-a68c-45e0-9ce1-0a36af10c0c2",[],"help@foxy.io",{"_uid":3401,"equals":3402,"fields":3403,"component":3382},"1dbb8f11-613d-43cd-9e09-1b94f6e19219","Billing",[3404],{"_uid":3405,"name":3389,"type":3390,"label":13,"options":13,"required":24,"component":3317,"conditions":3406,"placeholder":13,"default_value":3407},"a0ac0d1b-bc4f-4a6c-a682-581d450b0b73",[],"help+billing@foxy.io",{"_uid":3409,"equals":3410,"fields":3411,"component":3382},"a0a53a50-7172-4a29-ba58-181e38874e12","Partnerships",[3412],{"_uid":3413,"name":3389,"type":3390,"label":13,"options":13,"required":24,"component":3317,"conditions":3414,"placeholder":13,"default_value":3415},"7aa011d9-f374-4aed-b5a5-929b54aaf152",[],"partners@foxy.io",{"_uid":3417,"equals":3331,"fields":3418,"component":3382},"a4cd431f-25d5-41c7-bfdc-02c908c8fb47",[3419],{"_uid":3420,"name":3389,"type":3390,"label":13,"options":13,"required":24,"component":3317,"conditions":3421,"placeholder":13,"default_value":3392},"f5d52168-d6ae-451b-94ee-2ced1cbd28ad",[],{"_uid":3423,"equals":3424,"fields":3425,"component":3382},"25aba1ed-eb41-4bbc-aa89-f7a7167ea86e","Other",[3426],{"_uid":3427,"name":3389,"type":3390,"label":13,"options":13,"required":24,"component":3317,"conditions":3428,"placeholder":13,"default_value":3392},"f40dfaef-c203-4b71-bf4e-e1b43cef192b",[],{"_uid":3430,"component":3431},"e9c53a05-f40a-4510-aaf8-bc072a235a0c","form___subject",{"_uid":3433,"name":3434,"type":3435,"label":3436,"options":13,"required":33,"component":3317,"placeholder":13},"a4c4d385-fff4-4978-99fb-b68cfea623d6","message","textarea","Message",{"_uid":3438,"name":3439,"type":3325,"label":3440,"options":3441,"required":33,"component":3317,"conditions":3442,"placeholder":13},"8a3c9f85-f438-427d-9c7a-d7b295a14b5b","existing_user","Are you an existing user?","No, Yes",[3443],{"_uid":3444,"equals":3445,"fields":3446,"component":3382},"115933d6-262a-4b59-8fa8-579c5ad73de1","Yes",[3447],{"_uid":3448,"name":3449,"type":333,"label":3450,"options":13,"required":33,"component":3317,"conditions":3451,"placeholder":13},"44b6ff23-98f0-4e95-b7f5-c23e06415c2d","subdomain","Store Subdomain",[],{"_uid":3453,"name":3454,"type":3325,"label":3455,"options":3456,"required":33,"component":3317,"conditions":3457,"placeholder":13},"922a5cef-3af2-4113-8855-36c7910e3ee3","user_type","What type of user are you?","Developer, Designer, Merchant",[],"POST",[3460],{"_uid":3461,"text":3462,"title":3471,"component":3472},"7323b90d-a93a-4bf1-baa9-20d0b7ead61b",{"type":324,"content":3463},[3464],{"type":335,"content":3465},[3466,3468,3469],{"text":3467,"type":333},"855.369.9227",{"type":2289},{"text":3470,"type":333},"9:30am-6pm Central M-F","Pre-sales, Sales, & Partnerships","contact___footer_column",{"type":324,"content":3474},[3475],{"type":335,"content":3476},[3477],{"text":3478,"type":333},"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,3488,3515],{"name":3489,"created_at":3490,"published_at":3491,"updated_at":3492,"id":3493,"uuid":3494,"content":3495,"slug":3509,"full_slug":3510,"sort_by_date":59,"position":3511,"tag_list":3512,"is_startpage":24,"parent_id":310,"meta_data":59,"group_id":3513,"first_published_at":3491,"release_id":59,"lang":65,"path":59,"alternates":3514,"default_full_slug":59,"translated_slugs":59},"Shipping","2023-01-19T16:28:43.170Z","2023-01-19T17:25:33.503Z","2026-05-19T18:05:41.768Z",28245,"d92c1375-75ba-48e1-bb02-a3ae35187e0b",{"_uid":3496,"icon":3497,"name":3489,"guides":3498,"summary":3499,"category":13,"component":297,"blog_posts":3500,"content_hub":24,"icon_custom":3501,"case_studies":3502,"faq_sections":3503,"help_articles":3504,"featured_guides":3505,"mailbox_category":13,"featured_articles":3506,"featured_blog_posts":3507,"featured_case_studies":3508},"ea45a64b-f203-4c73-8645-325761de650e","fa-truck",[],"How to configure shipping rules for your store.",[],{"id":59,"alt":59,"name":13,"focus":59,"title":59,"filename":13,"copyright":59,"fieldtype":81},[],[],[],[],[],[],[],"shipping","help\u002Fcategories\u002Fshipping",90,[],"2e7778d1-fab7-4b53-ae55-f3382610fa56",[],{"name":3516,"created_at":3517,"published_at":3518,"updated_at":3519,"id":3520,"uuid":517,"content":3521,"slug":3534,"full_slug":3535,"sort_by_date":59,"position":3536,"tag_list":3537,"is_startpage":24,"parent_id":310,"meta_data":59,"group_id":3538,"first_published_at":3539,"release_id":59,"lang":65,"path":59,"alternates":3540,"default_full_slug":59,"translated_slugs":59},"Handling Fees","2026-05-27T16:23:37.375Z","2026-06-24T21:24:10.659Z","2026-06-24T21:24:10.677Z",181081773640315,{"_uid":3522,"icon":13,"name":3516,"type":3523,"pinned":24,"summary":3524,"category":3494,"component":297,"blog_posts":3525,"icon_custom":3526,"case_studies":3528,"faq_sections":3529,"featured_guides":3530,"mailbox_category":13,"featured_articles":3531,"featured_blog_posts":3532,"featured_case_studies":3533},"dd16f338-bf49-45e8-a90b-023a0e26f296","simple","How to add handling charges to shipping on a per category basis.",[],{"id":59,"alt":59,"name":13,"focus":59,"title":59,"source":59,"filename":13,"copyright":59,"fieldtype":81,"meta_data":3527},{},[],[],[],[],[],[],"handling-fees","help\u002Fcategories\u002Fhandling-fees",-280,[],"974d4ec6-1616-404c-aa9b-ce7e823b41d8","2026-05-28T20:17:53.593Z",[],{},1784562227544]