Restriction Mode
The Restriction Mode determines how the plugin behaves when a visitor from a restricted country encounters a product. This is a store-wide setting - it applies to all restricted products equally.
Hide Completely (default)
| Behaviour | Details |
|---|---|
| Shop / category / search loops | Product is invisible - not rendered in any listing |
| Single product page (direct URL) | Returns HTTP 404 (not found) |
| Optional redirect | If a redirect URL is entered, visitors are sent there instead of a 404 |
When to use: When you want the product to appear as if it doesn't exist for restricted visitors. Ideal for legal compliance or regional exclusivity.
Redirect restricted visitors
Toggle this sub-option on and enter a destination URL. When a restricted visitor navigates directly to the product URL, they are redirected with a 302 response instead of receiving a 404. The redirect URL can be a page on your site (e.g. a "Not available in your region" landing page) or any external URL.
The redirect applies only in Hide mode. The redirect URL is stored only when Hide mode is active and the redirect toggle is on; switching modes clears the stored URL.
Catalog Only
| Behaviour | Details |
|---|---|
| Shop / category / search loops | Product is invisible - not rendered in any listing |
| Single product page (direct URL) | Page loads normally |
| Add to Cart (default) | Blocked - button is removed |
| Add to Cart (optional) | Can be allowed with the sub-toggle |
When to use: Wholesale products shared via a private link, promotional products distributed by email, or any scenario where you want to hide the product from browse-discovery but still allow access via direct URL.
Allow purchase via direct URL
By default, even when the single product page loads, the Add to Cart button is removed for restricted visitors. Enable this toggle to allow purchase through the direct URL while still keeping the product hidden from the catalog.
Show Restriction Message
| Behaviour | Details |
|---|---|
| Shop / category / search loops | Product is visible |
| Single product page (direct URL) | Page loads; price and Add to Cart are replaced with your custom message |
| Add to Cart | Blocked on the product page (server-side validation also blocks API attempts) |
When to use: When you want transparency - show the product to all visitors but clearly explain it isn't purchasable in their region. Good for informational catalogues or stores that want to signal intent to expand.
Configure the message text in Restriction Message and its position in Message Position.