# Service Regions

### What is Service Regions?

Service Regions allows you to control which countries are available across your Partner Panel.

You can manage:

* Country visibility
* Phone codes
* Default country selection

Only **Active countries** will appear in country dropdown and phone number selection fields across the platform.

***

### Benefits of Service Regions

* 🌍 Control which countries are supported in your ecosystem.
* 📞 Ensure only valid phone codes are available for selection.
* ⚙️ Maintain cleaner signup and profile workflows.
* 🎯 Set a default country for better user experience.
* 🔐 Prevent unsupported regions from being selected.

***

#### 1. Accessing Service Regions Management

**a.  Navigate to the Configuration Section**

1. Go to the **Partner Panel**.
2. From the left sidebar, click **“Configurations”**.
3. Scroll on the top bar, and then click on the “**Service Regions”** subtab.

<figure><img src="https://1613146696-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZpVksvLNWoWVCzCZ4a1O%2Fuploads%2FilWbRK12GvD9bJqDdxbl%2Fimage.png?alt=media&#x26;token=95ba4526-8d84-49df-97af-5d88964bd5bd" alt=""><figcaption></figcaption></figure>

4. You will see a table listing all available countries with the following columns: Country Name, Country Code, Phone Code, Flag, Active, Default.

<figure><img src="https://1613146696-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZpVksvLNWoWVCzCZ4a1O%2Fuploads%2FZRDSeQZbpRhQ1fLVyOWD%2Fimage.png?alt=media&#x26;token=8d9963ab-5124-4c5f-9219-7afb57f60830" alt=""><figcaption></figcaption></figure>

**b. Using the Search Bar**

At the top of the page, a Search bar is available to help you quickly locate specific countries.

You can search by:

1. Country name
2. Country code
3. Phone code

<figure><img src="https://1613146696-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZpVksvLNWoWVCzCZ4a1O%2Fuploads%2FgupqWE7RV8IvK6tfYXAc%2Fimage.png?alt=media&#x26;token=186f1023-daf6-4fa0-9aef-fd9d738c7040" alt=""><figcaption></figcaption></figure>

***

#### 2. Managing Active Countries

The **Active** toggle determines whether a country is available across your platform.

**a. Enabling or Disabling a Country**

1. Locate the country in the list (use the Search bar if required).
2. Use the **Active** toggle to turn it ON or OFF.

When a country is marked as Active:

1. It appears in all country dropdown fields.
2. Its phone code appears in phone number selection fields.

{% hint style="info" %}
**Important Note**

At least one country must remain Active at all times.
{% endhint %}

<figure><img src="https://1613146696-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZpVksvLNWoWVCzCZ4a1O%2Fuploads%2FNGaqjfrmyf0tXeajGXVZ%2Fimage.png?alt=media&#x26;token=3135a032-da31-422a-86e2-c752701a510e" alt=""><figcaption></figcaption></figure>

***

#### 3. Using Bulk Actions

Service Regions Management supports bulk activation and deactivation of countries.

**a. Performing Bulk Actions**

1. Select one or more countries using the checkbox next to each country.
2. Once at least one country is selected, the **Gear icon** becomes enabled.
3. Click the Gear icon to perform one of the following actions:
   1. Activate selected countries
   2. Deactivate selected countries

{% hint style="info" %}
**Important Notes**

1. The Gear icon remains disabled until at least one country is selected.
2. At least one country must remain Active at all times.
3. Bulk actions apply only to the selected countries.
   {% endhint %}

<figure><img src="https://1613146696-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZpVksvLNWoWVCzCZ4a1O%2Fuploads%2F7ccWt3hgvLdfwoGIx6cN%2Fimage.png?alt=media&#x26;token=62c33776-6997-4006-bc49-223cc7628bef" alt=""><figcaption></figcaption></figure>

***

#### 4. Setting the Default Country

The Default toggle allows you to define a primary country for your account.

**a. Setting a Default Country**

1. Ensure the country is marked as **Active**.
2. Enable the **Default** toggle for that country (Only one country can be set as Default at a time.)

**b. Default Country Behaviour**

The Default country:

1. May be preselected in relevant forms.
2. Is used as a fallback if automatic location detection does not match an Active country.

<figure><img src="https://1613146696-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZpVksvLNWoWVCzCZ4a1O%2Fuploads%2FY60tOplgnofg6CqlTPQg%2Fimage.png?alt=media&#x26;token=f20655b7-1968-4caf-892d-66b183d7571a" alt=""><figcaption></figcaption></figure>

***

#### 5. Platform Behaviour After Configuration

Once configured, the Service Regions settings apply across your platform, including:

1. Signup flows
2. Profile and address forms
3. Phone number country code selection
4. Any country selection dropdown

{% hint style="info" %}
If a user attempts to select a country that is not Active, they will be required to choose a supported country before proceeding.6. Important Considerations.
{% endhint %}

***

#### 6. Important Considerations

**a. Active Country Requirement**

1. The platform requires a minimum of one country to be marked as **Active** at all times.
2. If all countries are disabled, the configuration will not be valid.

**b. Default Country Rules**

1. A country must be marked as **Active** before it can be set as Default.
2. Only one country can be set as Default at a time.
3. If a new Default is selected, it automatically replaces the previous Default.

**c. Country Visibility**

Only countries marked as **Active** will:

1. Appear in country selection dropdown.
2. Appear in phone code selection fields.

{% hint style="info" %}
If a country is not visible in a dropdown, verify that it is marked as Active in Service Regions Management.
{% endhint %}

**d. Location Detection and Fallback Behaviour**

1. The system may attempt to detect a user’s location.
2. If the detected country is **Active**, it may be preselected.
3. If the detected country is **not Active**, the configured **Default** country will be used instead.

**e. Configuration Updates**

1. Updates made in Service Regions Management apply across the platform.
2. In some cases, refreshing the page may be required to reflect the latest configuration.

#### FAQ's

<details>

<summary>Who can configure Service Regions?</summary>

Only Partners can manage Service Regions.

</details>

<details>

<summary>What happens if I disable a country?</summary>

When a country is disabled:

* It will no longer appear in any country dropdown.
* Its phone code will not appear in phone number fields.
* Users cannot select that country.

</details>

<details>

<summary>Does disabling a country affect existing customers?</summary>

No. This configuration primarily affects new country selections and new signups. Existing customer records are not automatically modified.

</details>

<details>

<summary>Can I disable all countries?</summary>

No. At least one country must remain Active at all times.

</details>

<details>

<summary>Can I set more than one Default country?</summary>

No. Only one country can be marked as Default at a time.

</details>

<details>

<summary>Can I set a Default country that is not Active?</summary>

No. A country must be marked as Active before it can be set as Default otherwise the error will be shown as "Please mark the country as active"

</details>

<details>

<summary>What happens when I change the Default country?</summary>

The newly selected country becomes the Default immediately and replaces the previous Default.

</details>

<details>

<summary>How does the Default country work?</summary>

The Default country:

* May be preselected in relevant forms.
* Acts as a fallback if automatic location detection does not match an Active country.

</details>

<details>

<summary>What if a user attempts to sign up from a country that is not Active?</summary>

They will be required to select a supported (Active) country before continuing.

</details>

<details>

<summary>Do changes apply immediately?</summary>

Changes apply platform-wide after updating the configuration. In some cases, refreshing the page may be required.

</details>

<details>

<summary>Does this affect tax configuration or VAT rules?</summary>

No. Service Regions Management only controls country and phone code visibility. It does not configure taxes or compliance rules.

</details>

<details>

<summary>Can I search for countries in the list?</summary>

Yes. Use the search bar to find countries by:

* Country name
* Country code
* Phone code

</details>

<details>

<summary>Why is the Gear icon disabled?</summary>

The Gear icon is enabled only after selecting at least one country using the checkbox.

</details>

<details>

<summary>What actions are available through the Gear icon?</summary>

After selecting one or more countries, you can perform bulk actions such as:

* Activate selected countries
* Deactivate selected countries

</details>

<details>

<summary>Can I use bulk actions to set the Default country?</summary>

No. The Default country must be selected individually using the Default toggle.

</details>

<details>

<summary>What happens if I disable the current Default country?</summary>

The system will require another Active country to be set as Default.

</details>

<details>

<summary>Is there a limit to how many countries I can activate?</summary>

No. You may activate as many countries as your organization supports.

</details>

### Support

If you still have questions for our team, write to us at [**support@botpenguin.com**](mailto:support@botpenguin.com). We’ll get back to you within 48 hours.