City autocomplete
City suggestions at checkout — no typos in the address.
A city typed by hand is where address mistakes come from: typos, abbreviations, a village entered as a town. Here the customer types the first letters and picks the right place from the suggestions, and delivery services immediately find their branches there.
What it does
- Suggests cities and villages under the «City» field at checkout, from a directory loaded into the shop.
- Searches Ukrainian, Russian and English spellings at once, and puts larger places at the top of the list.
- Hands the delivery services the city name in the spelling their own directories use: Nova Poshta, Meest and Ukrposhta immediately offer branches in the chosen city.
- Pre-fills the city when checkout opens, guessing it from the customer's connection; the customer can always pick another one, and the pre-fill can be switched off.
- Suggests cities in the admin area too, when you create an order by hand.
- Lets you set how many letters must be typed before suggestions appear, and limit the directory to the countries you actually ship to.
- Works with any storefront design: no templates need editing.
What you need
- Tick the countries you deliver to and press «Update the city directory» — the download runs in the background and takes a few minutes.
- A working task queue: the directory is loaded by a background task.
- Internet access from the shop's server: the directory is downloaded from the open GeoNames database, and the city behind a customer's connection is looked up through a free third-party service.
What appears in the shop
This is what a shopper sees once it is installed.
- At checkout, a suggestion list appears under the «City» field: the customer types the first letters and picks their city or village. Suggestions plug into the city field of any design — no separate template is needed and nothing has to be edited in the design editor.
What’s fixed
Messages shown while the place directory updates now appear in the language of the staff member who pressed “Update the directory”. Before, some of them always came out in Russian, and large numbers weren’t grouped by thousands.
What’s new
City suggestions can now come from the Nova Poshta directory. Customers see only the towns and villages the carrier delivers to, and pick them spelled exactly as the carrier spells them. With the codifier, “Кам’янець-Подільський” was written with a different apostrophe than Nova Poshta uses, and delivery to that city could fail to show up.
The directory appears in the “Settlement directory” field once the Nova Poshta add-on is switched on and has loaded its cities. You don’t need to load it yourself, because Nova Poshta refreshes it every night along with its branches. If you switch Nova Poshta off, suggestions go back to the codifier.
Before updating
This version needs CartiX 2.131.0 or newer. Update the shop first.
What’s new
When no city matches the typed name, the suggestion list now shows a “Nothing found” line. On a Russian or English page the shop suggests writing the name in Ukrainian, for example “Київ”: the official directory of Ukraine knows names in Ukrainian only.
What we fixed
A city detected from the shopper’s connection was filled in in Latin letters, for example “Staryi Liubar”. It is now filled in in Ukrainian, and if the city is not in the directory, the field stays empty.
What’s new
A city typed out in full now counts as chosen when it matches a suggestion: there is no need to pick “Kyiv” from the list separately. If the shopper leaves the field without picking a city, a line appears under it — “Pick your city from the suggestions to see the delivery options” — so they understand why no delivery options are shown yet.
A city filled in from an earlier checkout or a saved address is now checked against the directory. An unfinished name from a previous visit no longer opens the delivery options.
What's new
City suggestions at checkout attach their files together with the page's other files, even when the page has several city fields.
The add-on's styling and scripts are now joined with the theme files into a shared compressed file, so the page loads with fewer requests. This works together with core 2.86.0, so the add-on requires it: update the shop first, then the add-on. How joining works: https://cartixx.com/docs/theme/assets
Loading the list of towns is now recorded like the shop's other long-running work. If a run breaks off, the shop shows it in Settings → Diagnostics as "Unfinished work" — there was no way to learn about it before. Requires shop version 2.47.0 or newer.
The directory tells you its state
The loading block is now called «Settlement directory», and next to the button it says what is inside: «The directory holds 29,703 settlements, loaded on 04.09.2026». While the directory is empty it says so — and says that city suggestions do not work meanwhile.
Loading starts as soon as you press the button; there is no need to wait for the scheduler any more.
Settings that do not apply are out of the way
The country list belongs to GeoNames only, and the file link to the official codifier only. Both fields used to sit there at all times, and it was unclear which one applied to the chosen directory. Now you see the ones that matter.
The settlement directory is now a choice
The add-on settings now offer a choice: the official Ukrainian codifier (KATOTTG) or GeoNames. The codifier is the default. It is a single file from the ministry site: Ukrainian names of every village, the district and region next to the name, no keys and no third-party services. GeoNames stays for shops that ship beyond Ukraine.
The codifier is stored separately from GeoNames, so the directories never mix: no two «Kyiv» entries, one from each source. Both the storefront suggestion and the city lookup in the panel read the directory you selected.
A village is now shown with where it belongs: «Chotyrboky — Shepetivskyi district, Khmelnytskyi region». Without that you would be choosing blind: «Ivanivka» occurs 119 times in the country. Towns come above settlements, settlements above villages, and places that are gone from the latest revision leave the directory.
After the update, load the directory with the «Update the directory» button in the add-on settings.
The city suggestion shows addresses, not pieces of the directory
Typing «Kyiv» offered city districts, quarters and identical names one after another. Districts and quarters of cities, abandoned and destroyed villages and historical places are no longer shown. This works on an already loaded directory too; there is no need to refresh it.
The region is now shown next to the name, so villages with the same name are no longer confused. The region comes from the directory when it is refreshed.
A village is found by its Ukrainian name
Some villages are stored under a Latin name only — «Чотирбоки» sits there as «Chotyrboky», and the customer could not find their village at all. The typed name is now searched in its Latin spelling as well, using the Ukrainian transliteration standard.
An icon of its own
In the «Plugins» section and in the list of installed items the add-on now shows its own icon instead of an identical box, so you find the one you need at a glance. The icon appears on shops running version 1.30.0 and newer.
Первый релиз