This add-on is part of our Subscription plan.
Subscribe once — enjoy all add-ons without limits.
The add-on extends default CS-Cart geolocation, helps detect the customer city more flexibly, and uses that location data in storefront widgets and checkout. It is useful when you want to show the current city, allow manual selection, and adapt checkout to the selected location.
The add-on detects the customer city by IP via 2ip or SypexGeo, lets the customer choose a city manually, and applies the location data to checkout. It connects geolocation, storefront blocks, and checkout data in one workflow.
Automatic city detection by IP.
Choice between 2ip and SypexGeo.
Manual city selection on the storefront and confirmation popup.
Ready-made blocks for city selection and city information.
City, region, and country data applied to checkout.
Support for the cities and rus_cities add-ons.
Request limits and bot protection.
The add-on requests geolocation data by IP, stores the selected city in the session, and transfers the data into checkout customer fields. If a city management add-on is active, the detected city is matched with a database record. If no match is found, API data is used directly.
The administrator can choose the geolocation service, set the API key, limit requests, and hide the popup if it is not needed.
Have questions about the add-on?
The add-on detects the customer city by IP via 2ip or SypexGeo, lets the customer choose a city manually, and applies the location data to checkout. If a city management add-on is active, it uses its data and can match the detected city with a database record.
The add-on settings are available in Administration → Add-ons → Manage add-ons → Advanced Geolocation.
The add-on blocks are added in Design → Block manager: MS: Customer location and MS: City info.
The city list is available in the admin section MS: Advanced Geolocation. Cities.
Geolocation service — choose 2ip or SypexGeo.
API key — shared key field for the selected service. Use a SypexGeo key for SypexGeo, or a paid 2ip key for 2ip.
Requests count — daily request limit for one user.
Hide popup — disables the city confirmation popup.
1. Open the add-on settings and select a geolocation service.
2. Enter the API key if the selected service requires one.
3. Set the request limit and enable popup hiding if needed.
4. Add the city selection block to the storefront if you want manual city selection.
5. Add the city info block if you want to show additional text or a link.
6. If the cities or rus_cities add-on is used, check the city list and the extra city fields.
1. Open the storefront from a new IP and check automatic city detection.
2. Select a city manually and make sure it is stored in the session.
3. Check that checkout fields are filled with city, region, and country data.
4. If the popup is enabled, make sure it appears after city detection.
5. If city management add-ons are used, verify the selected city in their list and in the add-on blocks.
v1.2.0 from 2026-02-21
[*] Added a geolocation service selector between 2ip and SypexGeo
[*] Reused the API key field for the paid 2ip key and the SypexGeo key
[*] Updated city detection logic to respect the selected service
v3.1.0 from 2025-12-23
[+] Added the remaining requests counter
[!] Fixed city search by internal substring match
[-] Removed redundant city creation logic from the module, the flow now uses the external cities add-on
[!] Fixed the close icon in the popup
[+] Added API methods for city management
[+] Added the ability to get a city from the customer profile or the default checkout location setting
[+] Refactored the module
[+] Added compatibility with the new cities add-on in CS-Cart 4.19+
v3.0.0 from 2025-01-30
[*] Updated block names and descriptions, as well as logos
[+] Refactored the module
v2.1.0 from 2024-05-15
[+] Standardized the module code according to the template
[+] Standardized the module text files
[*] Changed short <? tags to regular <?php tags
v2.0.0 from 2023-05-15
[*] Added licensing
Legend:
[+] Added
[-] Removed
[*] Changed
[!] Bug fix
