Updated: 12 November 2026 · Applies to: Osclass 8.4.0 (checked in the 8.4.0 source code)

In Osclass 8.4.0, locations are under International › Locations in the admin area (older guides say Settings › Locations, which no longer exists). The fastest way to add a country is Import new, which brings in the country with all its regions and cities. To add one by hand, click Add new next to Countries, then Expand a country to add its regions, and expand a region to add its cities.

Osclass groups every listing by country, region and city, so buyers can filter by place. Add only the places your site really serves: a short, correct list is easier to search than every country in the world.

Which Osclass version do you have?

The original Osclass project stopped at version 3.7.4. Development continues in the osclass-classifieds/osclass repository on GitHub, where 8.4.0 is the current release at the time of writing (PHP 7.4 or newer). The steps below are for 8.x. If your admin area looks different, check the version under Tools › Changelog.

Method 1: import a country with its regions and cities

  1. Log in at https://example.com/oc-admin/ as an administrator.
  2. Go to International › Locations.
  3. Click Import new at the top of the Countries column.
  4. Pick the country in Import a location and click Import. Osclass confirms with "The location has been imported".

The list of countries is downloaded from the Osclass project's own server (252 countries when we checked), and countries you already have are left out. If the box says "No locations available.", your server cannot reach that address over HTTPS: check the server's outgoing connections or firewall, or add the locations by hand. The admin menu also has a Market › Locations screen for location packages.

Method 2: add a country by hand

  1. In International › Locations, click Add new next to Countries.
  2. Enter the Country name and the Country code: exactly two letters, the ISO 3166 code, for example IN for India or GB for the United Kingdom. Any other length is refused with "Invalid country code! It must be exactly 2 letters."
  3. Click Add country. Osclass shows "India has been added as a new country".
  4. To fill in more details, click the country name. The edit box has Native name, Phone code (without the plus sign, for example 91), Currency code (three capital letters, for example INR) and Slug (used in friendly URLs; it must be unique and can be left blank).

Add regions and cities

  1. Click Expand next to the country. Its regions appear in the Regions column.
  2. Click Add new in the Regions column, enter the region name (a state or county, such as Kerala) and click Add region.
  3. Click Expand next to the region. Its cities appear in the Cities column.
  4. Click Add new in the Cities column, enter the city name and click Add city.
  5. Click a city name to add its Native name, Latitude, Longitude and Slug. Coordinates help themes and plugins that show maps or search by distance.

If a country or region of that name is already there, Osclass answers "... already was in the database" and does not add a second copy.

Deleting a location: read this first

Deleting a country, region or city cannot be undone. Osclass warns: "Listings associated to this location will be deleted. Users from this location will be unlinked, but not deleted." Take a backup under Tools › Backup data first, and rename a place instead of deleting it where you can. Osclass also notes that changing locations can make your statistics wrong until they are recalculated.

Tips

  • Add locations before you open the site to sellers, so listings are filed in the right place from the start.
  • If your theme shows city names in another language, fill in Native name for each.

Related Osclass guides: How to properly create pages in OSClass and How to setup a mail server in OSClass.

Related services

Web hosting

shared hosting on Virtualmin with NVMe storage, free SSL and email.

Managed cPanel VPS

cPanel included; we handle updates, security and monitoring.

Hire an expert

engineers per 15 minutes, per hour or per month, with no contract.

Was this answer helpful?

Still stuck? Open a ticket