---
title: "Country Field - Advanced Custom Fields"
description: "Add a country selector to your forms with visitor country detection. Improve user experience and increase conversions now!"
url: "https://www.tassos.gr/docs/advanced-custom-fields/fields/country"
date: "2026-05-01T12:28:36+00:00"
language: "en-GB"
---

[ Home ](https://www.tassos.gr/index.php?option=com_content&view=category&layout=blog&id=24&Itemid=1088) / [ Advanced Custom Fields ](https://www.tassos.gr/index.php?option=com_content&view=category&id=44) / [ Fields Types ](https://www.tassos.gr/index.php?option=com_content&view=category&id=64)

#  Country Field

##  Add a country selector to your forms with visitor country detection. Improve user experience and increase conversions now!

 Country Field Has More Options in Pro

 Additional features are locked in the free version. Upgrade to Advanced Custom Fields Pro to get the most out of it.

 [ Unlock all features ](https://www.tassos.gr/joomla-extensions/advanced-custom-fields/subscribe)

The Country custom field gives you the ability to select one country or more through a list of countries by displaying either it's name or code name. The Countries field also allows you to detect your country via your IP Address so it will prepopulate the field for you.[](#how_to_add_a_country_custom_field_to_joomla_articles)

## [How to add a Country Custom Field to Joomla! Articles](#how_to_add_a_country_custom_field_to_joomla_articles)

To add a Country Field on Joomla Articles, go to Content > Articles > Your Article > General Tab > Select ACF - Country Type.

![acf-country-field-settings](https://www.tassos.gr/images/acf-country-field-settings.png)

Below we will describe each field's options.

 | Name | Description |
|---|---|
| Name | The name will be used to identify the field. Leave this blank and Joomla will fill in a default value from the title. |
| Label | The label of the field to display. |
| Description | A description of the field that will be displayed in the label tooltip. |
| Required | Is this a mandatory field? |
| Return Value | Specify the return value on front-end.   Choose between country name or country code to appear on the front-end. |
| Multiple Country Selection | Allow selection of multiple countries.. |

### [Pro Options](#pro-options)

 | Name | Description |
|---|---|
| Detect Visitor Country | If enabled, the field will try to detect and prefill the visitor's country.      It requires the TGeoIP plugin to be installed. |

## [Usage](#usage)

Once you are in your Article's Edit screen, choose the "Fields" Tab to see the Country custom field as you can see in the screenshot below.

![acf-country-usage](https://www.tassos.gr/images/acf-country-usage.png)

This selectbox contains all the countries of the world and you can fast search the one you want just as you type in.

## [Frontend Display](#frontend)

Take a look at the screenshot below to see how it could be displayed in your frontend.

![acf-country-frontend](https://www.tassos.gr/images/acf-country-frontend.png)

## [Frequently Asked Questions](#frequently-asked-questions)

### [How to display countries by their names or code names](#display_country_name_code_name)

The setting that handles how to display the countries, with their name or their code name, is called *Return Value* and by default is set to Country Name. This means that on the front end, countries will appear with their full name.

If you want to display countries with their code name, you will need to select the option Country Code on the setting Return Value which in return, will make countries appear with their Code Name (Example: Greece will appear as GR).

### [How to select multiple countries](#select_multiple_countries)

By default, the setting *Multiple Country Selection* is disabled which means you will only be able to select a single country in the Article's Fields Tab.

If you desire to select more than one country you will need to enable the setting Multiple Country Selection, which in return will allow you to select multiple countries in the Article's Fields Tab.

### [How to detect visitor's country and prepopulate country list](#detect_visitors_country_prepopulate)

With this setting, called *Detect Visitor Country*, you can detect the visitor's IP Address and prepopulate the country field. What it does is it takes the IP Address of the visitor and translates it to a country. The GeoIP plugin must be enabled in order to work.

To enable the GeoIP Plugin, go to Extensions > Manage and search for "System - Tassos.gr GeoIP Plugin".

Read our full guide on how to set up GeoIP plugin here: [How to enable Geolocation features in Tassos.gr extensions](https://www.tassos.gr/kb/general/how-to-enable-geolocation-features-in-tassos-gr-extensions)

## [Frequently Asked Questions](#faq)

### [How can I override the layout of "ACF - Country" custom field?](#how-can-i-override-the-layout-of-acf-country-custom-field)

To override the "ACF - Country" custom field, read here: [How to override the "ACF - Country" custom field](https://www.tassos.gr/joomla-extensions/advanced-custom-fields/docs/how-to-create-an-alternative-layout-for-joomla-custom-fields#override_render_layout).

 Country Field Has More Options in Pro

 Additional features are locked in the free version. Upgrade to Advanced Custom Fields Pro to get the most out of it.

 [ Unlock all features ](https://www.tassos.gr/joomla-extensions/advanced-custom-fields/subscribe)

 Last updated on Mar 4th 2025 10:03

## Schema

```json
{
    "@context": "https://schema.org",
    "@type": "BreadcrumbList",
    "itemListElement": [
        {
            "@type": "ListItem",
            "position": 1,
            "name": "Home",
            "item": "https://www.tassos.gr"
        },
        {
            "@type": "ListItem",
            "position": 2,
            "name": "Home",
            "item": "https://www.tassos.gr/docs"
        },
        {
            "@type": "ListItem",
            "position": 3,
            "name": "Advanced Custom Fields",
            "item": "https://www.tassos.gr/docs/advanced-custom-fields"
        },
        {
            "@type": "ListItem",
            "position": 4,
            "name": "Fields Types",
            "item": "https://www.tassos.gr/docs/advanced-custom-fields/fields"
        },
        {
            "@type": "ListItem",
            "position": 5,
            "name": "ACF Country - Add a Country dropdown field in Joomla",
            "item": "https://www.tassos.gr/docs/advanced-custom-fields/fields/country"
        }
    ]
}
```

```json
{
    "@context": "https://schema.org",
    "@type": "Article",
    "mainEntityOfPage": {
        "@type": "WebPage",
        "@id": "https://www.tassos.gr/docs/advanced-custom-fields/fields/country"
    },
    "headline": "ACF Country - Add a Country dropdown field in Joomla",
    "image": {
        "@type": "ImageObject",
        "url": "https://www.tassos.gr/"
    },
    "publisher": {
        "@type": "Organization",
        "name": "Tassos",
        "logo": {
            "@type": "ImageObject",
            "url": "https://www.tassos.gr/https://www.tassos.gr/media/brand/logo-text.png"
        }
    },
    "author": {
        "@type": "Person",
        "name": "Sotiris Katsaniotis",
        "url": "https://www.tassos.gr/docs/advanced-custom-fields/fields/country"
    },
    "datePublished": "2017-05-06T00:40:15+03:00",
    "dateCreated": "2017-05-06T00:40:15+03:00",
    "dateModified": "2025-03-04T10:30:48+02:00"
}
```

```json
{
    "@context": "https://schema.org",
    "@type": "FAQPage",
    "mainEntity": [
        {
            "@type": "Question",
            "name": "How can I override the layout of "ACF - Country" custom field?",
            "acceptedAnswer": {
                "@type": "Answer",
                "text": "To override the "ACF - Country" custom field, read here: How to override the "ACF - Country" custom field."
            }
        }
    ]
}
```