International Reseller is a WooCommerce extension that provides territory-based access control for shop managers. It allows you to assign shop managers to specific countries, regions, and languages, automatically restricting their access to only the orders, customers, analytics, and content that belong to their assigned territory.
This is ideal for businesses that work with regional resellers, country-specific distributors, or multilingual content teams.
What it does
↑ Back to top- Restricts shop manager access to orders and customers from their assigned countries and regions
- Restricts content editing to assigned languages (with a supported translation plugin)
- Filters WooCommerce dashboard data to show only territory-relevant information
- Provides per-manager configuration for notifications, settings access, and override permissions
- Supports delegated administration through master shop managers
What it requires
↑ Back to top- WordPress 6.0 or higher
- WooCommerce 8.0 or higher
- For language features: WPML, Polylang, or TranslatePress (optional)
Installation
↑ Back to topTo start using a product from WooCommerce.com, you can use the “Add to store” functionality on the order confirmation page or the My subscriptions section in your account.
- Navigate to My subscriptions.
- Find the Add to store button next to the product you’re planning to install.
- Follow the instructions on the screen, and the product will be automatically added to your store.
Alternative options and more information at:
Managing WooCommerce.com subscriptions.
Setup and Configuration
↑ Back to topStep 1: Check your WooCommerce shipping settings
↑ Back to topInternational Reseller uses your WooCommerce shipping location settings to determine which countries are available for territory assignment. Before configuring the plugin, make sure your shipping settings are correct.
- Go to WooCommerce > Settings > General.
- Under Shipping location(s), ensure you have selected the countries you ship to.
- The plugin supports all WooCommerce shipping modes:
- Ship to all countries — all countries will be available for assignment
- Ship to specific countries only — only your selected countries will appear
- Ship to all countries you sell to — countries from your “Selling locations” setting will be used
If shipping is disabled in your store, the plugin will display a helpful message with a direct link to your WooCommerce settings.
Step 2: Ensure you have shop managers
↑ Back to topThe plugin works with WordPress users who have the Shop Manager role. If you haven’t created shop manager accounts yet:
- Go to Users > Add New.
- Fill in the user details.
- Set the Role to Shop Manager.
- Click Add New User.
Repeat for each regional manager, reseller, or distributor who needs restricted access.
Step 3: Open the plugin settings
↑ Back to topNavigate to WooCommerce > International Reseller. You will see a configuration card for each shop manager in your store.
Configuring Territory Assignments
↑ Back to topEach shop manager has a dedicated card showing their name and email address. The card contains several configuration sections.
Assigning countries (all regions)
↑ Back to topUse the Countries (no specific regions) dropdown to assign one or more countries to a manager. When you assign a country here without specifying regions, the manager gets access to all orders and customers from that entire country — regardless of state or province.
- Click the dropdown and select countries.
- Use the Select all button to assign all available countries.
- Use the Select none button to clear the selection.
Assigning specific regions
↑ Back to topIf you need finer control, use the Specific Regions section to assign individual states or provinces within a country.
- Click Add Country/Region.
- Select a country from the first dropdown.
- If the country has states or provinces, a second dropdown will appear. Select the specific regions.
- Repeat to add more country/region combinations.
- Click the X button next to a row to remove it.
How region rules work:
- If you assign a country in the “Countries” section (without regions), the manager has access to all regions in that country.
- If you assign a country with specific regions in the “Specific Regions” section, the manager only has access to orders and customers from those exact regions.
- You can combine both: assign some countries fully and other countries with specific regions.
Saving assignments
↑ Back to topAfter configuring all managers, click the Save Assignments button at the bottom of the page. A success notice will confirm your settings were saved.
Configuring Language Assignments
↑ Back to topLanguage-based content restrictions require a supported translation plugin: WPML, Polylang, or TranslatePress. If none of these are active, you will see a message indicating that no translation plugin was detected.
Assigning languages
↑ Back to topIf a translation plugin is active:
- In each manager’s card, find the Languages section (labeled with your plugin name, e.g., “WPML Languages”).
- Select one or more languages from the dropdown.
- Click Save Assignments.
What language restrictions do
↑ Back to top- Content filtering: Managers can only edit posts, pages, and products in their assigned languages.
- Automatic language switching: When a manager logs into the admin, the interface automatically switches to their first assigned language.
- Language-specific catalog: Product listings in the admin are filtered to show only the assigned language versions.
Multi-currency price editing (WPML/WCML only)
↑ Back to topIf you use WPML with WooCommerce Multilingual (WCML), an additional checkbox appears:
- Allow multi-currency pricing/tax editing — Enable this to let the manager edit product prices and taxes in different currencies.
This option only appears when both WPML and WCML are active.
Per-Manager Options
↑ Back to topEach manager’s card includes several toggles for fine-grained control.
Order notifications
↑ Back to top- Email me when an order matches my countries/regions
- When enabled, the manager receives an email notification whenever a new order’s shipping country/region matches their assignment.
- If the order has no shipping address, the billing address is used as a fallback.
- The notification is appended to the standard WooCommerce new order email.
Settings access
↑ Back to top- Allow access to WooCommerce settings
- By default, restricted managers are blocked from WooCommerce settings pages (Settings, Status, and WooCommerce Admin).
- Enable this checkbox to grant a specific manager access to these pages.
- Master shop managers always have settings access regardless of this setting.
Access overrides
↑ Back to topThree override checkboxes allow you to selectively bypass restrictions for individual managers:
- Allow access to all orders — The manager can see all orders regardless of territory assignment. Useful for managers who need a global view of order volume but should still have restricted customer and content access.
- Allow access to all customers — The manager can see all customers regardless of territory. Useful when customer communication is centralized but order management is regional.
- Allow access to WooCommerce Analytics — By default, analytics are blocked for restricted managers because WooCommerce’s pre-computed statistics cannot be filtered by territory at the query level. Enable this to grant access, understanding that analytics data will show store-wide figures.
Master Shop Managers
↑ Back to topMaster shop managers are trusted managers who can configure assignments for other shop managers.
Setting up masters
↑ Back to top- At the top of the International Reseller page, find the Master Shop Managers panel.
- Select one or more shop managers from the dropdown.
- Click Save Master Shop Managers.
What masters can do
↑ Back to top- View and edit territory and language assignments for all shop managers
- Add or remove other master shop managers
- Retain full access to WooCommerce (settings, analytics, orders, customers)
Who can manage masters
↑ Back to top- Administrators can always configure master managers
- Existing master managers can also manage the master list
- Regular shop managers can view assignments but cannot edit them
How Access Restrictions Work
↑ Back to topOrders
↑ Back to topWhen a shop manager has territory assignments, they can only see orders where the shipping country and region match their assignments. If an order has no shipping address, the billing address is used instead.
This filtering applies to:
- The WooCommerce Orders list in the admin
- Individual order access (direct URL is blocked if not in territory)
- REST API queries for orders
- Both legacy (post-based) and HPOS order storage
Customers
↑ Back to topThe customer list is filtered to show only customers whose address matches the manager’s assigned territories.
Content (posts, pages, products)
↑ Back to topWhen a translation plugin is active and languages are assigned, managers can only edit content in their assigned languages. The admin interface automatically switches to their first assigned language.
Analytics
↑ Back to topWooCommerce Analytics uses pre-computed data that cannot be reliably filtered by territory. To prevent managers from seeing store-wide figures, analytics access is blocked by default. You can grant access per manager using the override checkbox.
WooCommerce settings
↑ Back to topSettings pages are blocked by default for restricted managers. Use the per-manager checkbox or master manager status to grant access.
Unassigned managers
↑ Back to topIf a shop manager has no territory or language assignments, they retain full access. The plugin only restricts managers who have explicit assignments.
Frequently Asked Questions
↑ Back to topTroubleshooting
↑ Back to topNo countries appear in the assignment dropdowns
↑ Back to topCheck your WooCommerce shipping settings at WooCommerce > Settings > General > Shipping location(s). The plugin uses your shipping countries to populate the territory options. If shipping is disabled, no countries will be available.
A shop manager can still see all orders
↑ Back to top- Verify the manager has been assigned at least one country or region.
- Check that the assignments were saved (you should see a success notice).
- Administrators are always excluded from restrictions. Make sure the user’s role is Shop Manager, not Administrator.
- Check the “Allow access to all orders” override checkbox — if enabled, territory filtering is bypassed for orders.
Language options don’t appear
↑ Back to topLanguage assignment requires an active translation plugin (WPML, Polylang, or TranslatePress). Install and activate one of these plugins, then return to the International Reseller settings. The language dropdown will appear automatically.
A manager cannot edit products in their language
↑ Back to top- Verify the manager has languages assigned in the International Reseller settings.
- Check that the translation plugin is active and the language exists in the plugin’s configuration.
- For WPML: ensure the product has a translation in the assigned language.
Master managers panel is not visible
↑ Back to topThe Master Shop Managers panel is only visible to administrators and existing master managers. If you are a regular shop manager, you will not see this panel.
Compatibility
↑ Back to top| Software | Version |
|---|---|
| WordPress | 6.0+ |
| WooCommerce | 8.0 — 10.5.0 |
| WPML | Supported (optional) |
| Polylang | Supported (optional) |
| TranslatePress | Supported (optional) |
| WooCommerce HPOS | Fully compatible |
| PHP | 7.4+ |
Advanced configuration
↑ Back to topThere’s a lot of freedom here to create sections you feel are necessary to explain setup or different configurations.
FAQs
↑ Back to top
Does the plugin work without WPML?
Yes. Territory-based features (orders, customers, notifications) work with WooCommerce alone. WPML, Polylang, or TranslatePress are only needed for language-based content restrictions.
What happens if a shop manager is not assigned to any territory?
Unassigned managers keep full access. No restrictions are enforced until you explicitly assign countries, regions, or languages.
Can I assign a manager to multiple countries?
Yes. Each manager can be assigned to any number of countries and any number of specific regions within those countries.
How do order notifications work?
When enabled for a manager, the plugin checks each new order’s shipping country and region against the manager’s assignments. If there’s a match, the manager’s email is added to WooCommerce’s standard new order notification recipients. If the order has no shipping address, the billing address is used.
Can a manager have both full country access and specific regions in another country?
Yes. You can assign Germany (all regions) in the “Countries” section while simultaneously assigning specific US states like California and New York in the “Specific Regions” section.
Why are analytics blocked by default?
WooCommerce Analytics uses pre-computed aggregate statistics. These cannot be reliably filtered by territory at the database query level. Showing unfiltered analytics to a territory-restricted manager could reveal store-wide revenue and order data outside their territory. Blocking by default is the safe choice, with an easy per-user override.
Will this plugin slow down my store?
No. The plugin uses standard WordPress and WooCommerce filters with no additional database tables. Filtering is applied only in the admin area for shop managers with active assignments. Front-end store performance is unaffected.
Is the plugin compatible with WooCommerce HPOS?
Yes. International Reseller fully supports High-Performance Order Storage (HPOS) and works with both HPOS and legacy post-based order storage.
