Add or remove deny list countries
Last updated on October 24, 2024
Introduction
The country deny list feature enables you to deny specific countries, preventing those countries' users from accessing your games. You can set which countries are in the deny list in your games that are managed in your publisher namespace in the AccelByte Gaming Services (AGS) Admin Portal.
AGS Shared Cloud
The country deny list feature is not yet supported in AGS Shared Cloud. Also, at this time, this feature is called the "blacklist" in the user interface and API.
Prerequisites
Ensure you have access to the AGS Admin Portal.
Ensure that you have the following permissions.
Usage Resource Action Get Country blacklist ADMIN:NAMESPACE:{namespace}:MISC
READ Update Country blacklist ADMIN:NAMESPACE:{namespace}:MISC
UPDATE
Add a country to the deny list
- In the AGS Admin Portal, go to your publisher namespace, then go to Game Setup > Country Deny List. On the Countries page, you will see two lists: Available Countries and Denied Countries. The Available Countries list show all the countries that you can add to the country deny list.
- In the Available Countries list, you can scroll through the list or type in the exact name of the countries you want to add to the deny list.
- Tick the checkbox or click on the name of the countries you want to add to the deny list.
- After selecting the countries you want to add to the deny list, click the right arrow (>) button to move the selected countries to the list. Users from the newly denied countries will immediately be prevented from creating a new account or signing in to your game.
note
- Denied countries will be removed from the Country Information field in both the registration form and profile update form.
- Users from the denied countries with existing accounts in your game will immediately be blocked from accessing their account.
- AGS only looks at a user's country information stored in their profile to determine whether they can access your game or not. A user who signs in with an IP address from a denied country but has a non-denied country in their profile information will still be able to access their account.
Remove a country
To remove a country from the deny list, follow these steps:
- In the AGS Admin Portal, go to your publisher namespace, then go to Game Setup > Country Deny List. On the Countries page, you will see two lists: Available Countries and Denied Countries. The Denied Countries list show all the countries that you can remove and add back to the Available Countries list.
- In the denied countries list, you can scroll through the list or type in the exact name of the countries you want to remove.
- Tick the checkbox or click on the name of the countries you want to remove from the denied countries list.
- After selecting the countries you want to deny, click the left arrow (<) button to move the selected countries to the Available Countries list. Users from the selected countries will immediately be allowed to access your game.
note
- Countries that have been removed from the denied countries list will immediately be available for selection in the registration and profile update forms.
- Users from the countries that have been removed from the denied countries list will be able to register for a new account. If they have existing accounts, they can sign in again and update their profile.