{"id":333297,"date":"2026-07-05T17:47:11","date_gmt":"2026-07-05T17:47:11","guid":{"rendered":"https:\/\/wordpress.org\/plugins\/custom-shipping-regions-for-woocommerce\/"},"modified":"2026-07-05T17:46:48","modified_gmt":"2026-07-05T17:46:48","slug":"custom-shipping-regions-for-woocommerce","status":"publish","type":"plugin","link":"https:\/\/wordpress.org\/plugins\/custom-shipping-regions-for-woocommerce\/","author":10299707,"comment_status":"closed","ping_status":"closed","template":"","meta":{"version":"1.0","stable_tag":"1.0","tested":"7.0","requires":"5.8","requires_php":"7.4","requires_plugins":null,"header_name":"Custom Shipping Regions for WooCommerce","header_author":"kushan86","header_description":"Add custom states\/regions (districts, provinces, counties...) for any country in WooCommerce, so you can build region-based Shipping Zones. Comes pre-loaded with all 25 Sri Lankan districts as a working example.","assets_banners_color":"","last_updated":"2026-07-05 17:46:48","external_support_url":"","external_repository_url":"","donate_link":"","header_plugin_uri":"","header_author_uri":"https:\/\/profiles.wordpress.org\/kushan86\/","rating":0,"author_block_rating":0,"active_installs":0,"downloads":34,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":{"1.0":{"tag":"1.0","author":"kushan86","date":"2026-07-05 17:46:48"}},"upgrade_notice":{"1.0":"<p>Initial release.<\/p>"},"ratings":[],"assets_icons":[],"assets_banners":[],"assets_blueprints":{},"all_blocks":[],"tagged_versions":["1.0"],"block_files":[],"assets_screenshots":[],"screenshots":{"1":"Custom Shipping Regions settings screen.","2":"Region selector inside a WooCommerce Shipping Zone."}},"plugin_section":[],"plugin_tags":[12898,3546,129143,14824,286],"plugin_category":[45],"plugin_contributors":[270233],"plugin_business_model":[],"class_list":["post-333297","plugin","type-plugin","status-publish","hentry","plugin_tags-regions","plugin_tags-shipping","plugin_tags-shipping-zones","plugin_tags-states","plugin_tags-woocommerce","plugin_category-ecommerce","plugin_contributors-kushan86","plugin_committers-kushan86"],"banners":[],"icons":{"svg":false,"icon":"https:\/\/s.w.org\/plugins\/geopattern-icon\/custom-shipping-regions-for-woocommerce.svg","icon_2x":false,"generated":true},"screenshots":[],"raw_content":"<!--section=description-->\n<p>Many countries \u2014 including Sri Lanka \u2014 don't have built-in state\/region data in WooCommerce, which makes it impossible to create region-based Shipping Zones out of the box.<\/p>\n\n<p><strong>Custom Shipping Regions for WooCommerce<\/strong> lets you define your own list of regions (districts, provinces, counties, states \u2014 whatever your country uses) for any country, directly from a simple settings screen. No coding required.<\/p>\n\n<p>Once saved, these regions appear:<\/p>\n\n<ul>\n<li>In WooCommerce \u2192 Settings \u2192 Shipping \u2192 Shipping Zones, under \"Limit to specific states\"<\/li>\n<li>On the checkout page, as a region dropdown for matching countries<\/li>\n<li>In customer billing\/shipping address fields<\/li>\n<\/ul>\n\n<p>The plugin comes pre-loaded with all 25 Sri Lankan districts as a working example the moment you activate it, so Sri Lankan store owners can start creating shipping zones immediately. Store owners in any other country can add their own region list in minutes.<\/p>\n\n<h4>Features<\/h4>\n\n<ul>\n<li>Works for any country, not just one<\/li>\n<li>Simple admin screen under WooCommerce \u2192 Custom Shipping Regions<\/li>\n<li>Fully compatible with WooCommerce Shipping Zones<\/li>\n<li>Pre-loaded with Sri Lankan districts out of the box<\/li>\n<li>Lightweight \u2014 one settings page, one option, no extra database tables<\/li>\n<li>Fails gracefully with an admin notice if WooCommerce is not active<\/li>\n<\/ul>\n\n<!--section=installation-->\n<ol>\n<li>Upload the plugin files to the <code>\/wp-content\/plugins\/custom-shipping-regions<\/code> directory, or install the zip file directly through the Plugins screen in WordPress.<\/li>\n<li>Activate the plugin through the 'Plugins' screen in WordPress.<\/li>\n<li>Make sure WooCommerce is installed and active.<\/li>\n<li>Go to WooCommerce \u2192 Custom Shipping Regions to review or edit the region list for any country (Sri Lanka is pre-loaded).<\/li>\n<li>Go to WooCommerce \u2192 Settings \u2192 Shipping \u2192 Shipping Zones to build zones limited to specific regions.<\/li>\n<\/ol>\n\n<!--section=faq-->\n<dl>\n<dt id=\"does%20this%20work%20without%20woocommerce%3F\"><h3>Does this work without WooCommerce?<\/h3><\/dt>\n<dd><p>No. This plugin only adds data used by WooCommerce's location and shipping features, so WooCommerce must be installed and active.<\/p><\/dd>\n<dt id=\"how%20do%20i%20add%20regions%20for%20my%20own%20country%3F\"><h3>How do I add regions for my own country?<\/h3><\/dt>\n<dd><p>Go to WooCommerce \u2192 Custom Shipping Regions, choose your country from the dropdown, and enter one region per line in the format CODE|Name (for example, CMB|Colombo). Save, and they'll immediately be available in Shipping Zones.<\/p><\/dd>\n<dt id=\"what%20happens%20to%20the%20sri%20lanka%20districts%20that%20come%20pre-loaded%3F\"><h3>What happens to the Sri Lanka districts that come pre-loaded?<\/h3><\/dt>\n<dd><p>They're added automatically the first time you activate the plugin. You're free to edit, remove, or replace them from the settings screen at any time.<\/p><\/dd>\n<dt id=\"can%20i%20do%20city-level%20or%20postcode-level%20shipping%20instead%20of%20regions%3F\"><h3>Can I do city-level or postcode-level shipping instead of regions?<\/h3><\/dt>\n<dd><p>Not currently. This plugin works at the state\/region level. For very granular shipping (e.g. specific cities or postcodes), WooCommerce's built-in postcode-based shipping zones are a better fit.<\/p><\/dd>\n<dt id=\"will%20this%20affect%20countries%20i%20haven%27t%20added%20regions%20for%3F\"><h3>Will this affect countries I haven't added regions for?<\/h3><\/dt>\n<dd><p>No. The plugin only changes data for countries where you've explicitly added regions.<\/p><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<h4>1.0<\/h4>\n\n<ul>\n<li>Initial release. Admin screen to manage custom regions per country, pre-loaded with Sri Lankan districts.<\/li>\n<\/ul>","raw_excerpt":"Add custom states\/regions for any country in WooCommerce, so you can build region-based Shipping Zones. Comes pre-loaded with all 25 Sri Lankan distri &hellip;","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/333297","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=333297"}],"author":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/kushan86"}],"wp:attachment":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=333297"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=333297"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=333297"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=333297"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=333297"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=333297"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}