> For the complete documentation index, see [llms.txt](https://docs.acymailing.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.acymailing.com/main-pages/custom-fields/samples.md).

# Examples

### Country field

To create a country field, first create a **new field** in AcyMailing.\
Then access your **database** (using phpMyAdmin for example), select the table "**#\_\_acym\_field**" and edit the field you just created.\
In the textarea **value**, copy paste the following code:

```javascript
[{"value":"AFG","title":"Afghanistan","disabled":"n"},{"value":"ALB","title":"Albania","disabled":"n"},{"value":"DZA","title":"Algeria","disabled":"n"},{"value":"ASM","title":"American Samoa","disabled":"n"},{"value":"AND","title":"Andorra","disabled":"n"},{"value":"AGO","title":"Angola","disabled":"n"},{"value":"AIA","title":"Anguilla","disabled":"n"},{"value":"ATA","title":"Antarctica","disabled":"n"},{"value":"ATG","title":"Antigua and Barbuda","disabled":"n"},{"value":"ARG","title":"Argentina","disabled":"n"},{"value":"ARM","title":"Armenia","disabled":"n"},{"value":"ABW","title":"Aruba","disabled":"n"},{"value":"AUS","title":"Australia","disabled":"n"},{"value":"AUT","title":"Austria","disabled":"n"},{"value":"AZE","title":"Azerbaijan","disabled":"n"},{"value":"BHS","title":"Bahamas","disabled":"n"},{"value":"BHR","title":"Bahrain","disabled":"n"},{"value":"BGD","title":"Bangladesh","disabled":"n"},{"value":"BRB","title":"Barbados","disabled":"n"},{"value":"BLR","title":"Belarus","disabled":"n"},{"value":"BEL","title":"Belgium","disabled":"n"},{"value":"BLZ","title":"Belize","disabled":"n"},{"value":"BEN","title":"Benin","disabled":"n"},{"value":"BMU","title":"Bermuda","disabled":"n"},{"value":"BTN","title":"Bhutan","disabled":"n"},{"value":"BOL","title":"Bolivia","disabled":"n"},{"value":"BIH","title":"Bosnia and Herzegowina","disabled":"n"},{"value":"BWA","title":"Botswana","disabled":"n"},{"value":"BVT","title":"Bouvet Island","disabled":"n"},{"value":"BRA","title":"Brazil","disabled":"n"},{"value":"IOT","title":"British Indian Ocean Territory","disabled":"n"},{"value":"BRN","title":"Brunei Darussalam","disabled":"n"},{"value":"BGR","title":"Bulgaria","disabled":"n"},{"value":"BFA","title":"Burkina Faso","disabled":"n"},{"value":"BDI","title":"Burundi","disabled":"n"},{"value":"KHM","title":"Cambodia","disabled":"n"},{"value":"CMR","title":"Cameroon","disabled":"n"},{"value":"CAN","title":"Canada","disabled":"n"},{"value":"CPV","title":"Cape Verde","disabled":"n"},{"value":"CYM","title":"Cayman Islands","disabled":"n"},{"value":"CAF","title":"Central African Republic","disabled":"n"},{"value":"TCD","title":"Chad","disabled":"n"},{"value":"CHL","title":"Chile","disabled":"n"},{"value":"CHN","title":"China","disabled":"n"},{"value":"CXR","title":"Christmas Island","disabled":"n"},{"value":"CCK","title":"Cocos (Keeling) Islands","disabled":"n"},{"value":"COL","title":"Colombia","disabled":"n"},{"value":"COM","title":"Comoros","disabled":"n"},{"value":"COG","title":"Congo","disabled":"n"},{"value":"COK","title":"Cook Islands","disabled":"n"},{"value":"CRI","title":"Costa Rica","disabled":"n"},{"value":"CIV","title":"Cote D'Ivoire","disabled":"n"},{"value":"HRV","title":"Croatia","disabled":"n"},{"value":"CUB","title":"Cuba","disabled":"n"},{"value":"CYP","title":"Cyprus","disabled":"n"},{"value":"CZE","title":"Czech Republic","disabled":"n"},{"value":"DNK","title":"Denmark","disabled":"n"},{"value":"DJI","title":"Djibouti","disabled":"n"},{"value":"DMA","title":"Dominica","disabled":"n"},{"value":"DOM","title":"Dominican Republic","disabled":"n"},{"value":"TMP","title":"East Timor","disabled":"n"},{"value":"ECU","title":"Ecuador","disabled":"n"},{"value":"EGY","title":"Egypt","disabled":"n"},{"value":"SLV","title":"El Salvador","disabled":"n"},{"value":"GNQ","title":"Equatorial Guinea","disabled":"n"},{"value":"ERI","title":"Eritrea","disabled":"n"},{"value":"EST","title":"Estonia","disabled":"n"},{"value":"ETH","title":"Ethiopia","disabled":"n"},{"value":"FLK","title":"Falkland Islands (Malvinas)","disabled":"n"},{"value":"FRO","title":"Faroe Islands","disabled":"n"},{"value":"FJI","title":"Fiji","disabled":"n"},{"value":"FIN","title":"Finland","disabled":"n"},{"value":"FRA","title":"France","disabled":"n"},{"value":"FXX","title":"France, Metropolitan","disabled":"n"},{"value":"GUF","title":"French Guiana","disabled":"n"},{"value":"PYF","title":"French Polynesia","disabled":"n"},{"value":"ATF","title":"French Southern Territories","disabled":"n"},{"value":"GAB","title":"Gabon","disabled":"n"},{"value":"GMB","title":"Gambia","disabled":"n"},{"value":"GEO","title":"Georgia","disabled":"n"},{"value":"DEU","title":"Germany","disabled":"n"},{"value":"GHA","title":"Ghana","disabled":"n"},{"value":"GIB","title":"Gibraltar","disabled":"n"},{"value":"GRC","title":"Greece","disabled":"n"},{"value":"GRL","title":"Greenland","disabled":"n"},{"value":"GRD","title":"Grenada","disabled":"n"},{"value":"GUM","title":"Guam","disabled":"n"},{"value":"GTM","title":"Guatemala","disabled":"n"},{"value":"GIN","title":"Guinea","disabled":"n"},{"value":"GNB","title":"Guinea-Bissau","disabled":"n"},{"value":"GUY","title":"Guyana","disabled":"n"},{"value":"HTI","title":"Haiti","disabled":"n"},{"value":"HMD","title":"Heard and McDonald Islands","disabled":"n"},{"value":"HND","title":"Honduras","disabled":"n"},{"value":"HKG","title":"Hong Kong","disabled":"n"},{"value":"HUN","title":"Hungary","disabled":"n"},{"value":"ISL","title":"Iceland","disabled":"n"},{"value":"IND","title":"India","disabled":"n"},{"value":"IDN","title":"Indonesia","disabled":"n"},{"value":"IRN","title":"Iran","disabled":"n"},{"value":"IRQ","title":"Iraq","disabled":"n"},{"value":"IRL","title":"Ireland","disabled":"n"},{"value":"ISR","title":"Israel","disabled":"n"},{"value":"ITA","title":"Italy","disabled":"n"},{"value":"JAM","title":"Jamaica","disabled":"n"},{"value":"JPN","title":"Japan","disabled":"n"},{"value":"JOR","title":"Jordan","disabled":"n"},{"value":"KAZ","title":"Kazakhstan","disabled":"n"},{"value":"KEN","title":"Kenya","disabled":"n"},{"value":"KIR","title":"Kiribati","disabled":"n"},{"value":"PRK","title":"Korea, North","disabled":"n"},{"value":"KOR","title":"Korea, South","disabled":"n"},{"value":"KWT","title":"Kuwait","disabled":"n"},{"value":"KGZ","title":"Kyrgyzstan","disabled":"n"},{"value":"LAO","title":"Laos","disabled":"n"},{"value":"LVA","title":"Latvia","disabled":"n"},{"value":"LBN","title":"Lebanon","disabled":"n"},{"value":"LSO","title":"Lesotho","disabled":"n"},{"value":"LBR","title":"Liberia","disabled":"n"},{"value":"LBY","title":"Libyan Arab Jamahiriya","disabled":"n"},{"value":"LIE","title":"Liechtenstein","disabled":"n"},{"value":"LTU","title":"Lithuania","disabled":"n"},{"value":"LUX","title":"Luxembourg","disabled":"n"},{"value":"MAC","title":"Macau","disabled":"n"},{"value":"MKD","title":"Macedonia","disabled":"n"},{"value":"MDG","title":"Madagascar","disabled":"n"},{"value":"MWI","title":"Malawi","disabled":"n"},{"value":"MYS","title":"Malaysia","disabled":"n"},{"value":"MDV","title":"Maldives","disabled":"n"},{"value":"MLI","title":"Mali","disabled":"n"},{"value":"MLT","title":"Malta","disabled":"n"},{"value":"MHL","title":"Marshall Islands","disabled":"n"},{"value":"MRT","title":"Mauritania","disabled":"n"},{"value":"MUS","title":"Mauritius","disabled":"n"},{"value":"MYT","title":"Mayotte","disabled":"n"},{"value":"MEX","title":"Mexico","disabled":"n"},{"value":"FSM","title":"Micronesia","disabled":"n"},{"value":"MDA","title":"Moldova","disabled":"n"},{"value":"MCO","title":"Monaco","disabled":"n"},{"value":"MNG","title":"Mongolia","disabled":"n"},{"value":"MNE","title":"Montenegro","disabled":"n"},{"value":"MSR","title":"Montserrat","disabled":"n"},{"value":"MAR","title":"Morocco","disabled":"n"},{"value":"MOZ","title":"Mozambique","disabled":"n"},{"value":"MMR","title":"Myanmar","disabled":"n"},{"value":"NAM","title":"Namibia","disabled":"n"},{"value":"NRU","title":"Nauru","disabled":"n"},{"value":"NPL","title":"Nepal","disabled":"n"},{"value":"NLD","title":"Netherlands","disabled":"n"},{"value":"ANT","title":"Netherlands Antilles","disabled":"n"},{"value":"NCL","title":"New Caledonia","disabled":"n"},{"value":"NZL","title":"New Zealand","disabled":"n"},{"value":"NIC","title":"Nicaragua","disabled":"n"},{"value":"NER","title":"Niger","disabled":"n"},{"value":"NGA","title":"Nigeria","disabled":"n"},{"value":"NIU","title":"Niue","disabled":"n"},{"value":"NFK","title":"Norfolk Island","disabled":"n"},{"value":"MNP","title":"Northern Mariana Islands","disabled":"n"},{"value":"NOR","title":"Norway","disabled":"n"},{"value":"OMN","title":"Oman","disabled":"n"},{"value":"PAK","title":"Pakistan","disabled":"n"},{"value":"PLW","title":"Palau","disabled":"n"},{"value":"PAN","title":"Panama","disabled":"n"},{"value":"PNG","title":"Papua New Guinea","disabled":"n"},{"value":"PRY","title":"Paraguay","disabled":"n"},{"value":"PER","title":"Peru","disabled":"n"},{"value":"PHL","title":"Philippines","disabled":"n"},{"value":"PCN","title":"Pitcairn","disabled":"n"},{"value":"POL","title":"Poland","disabled":"n"},{"value":"PRT","title":"Portugal","disabled":"n"},{"value":"PRI","title":"Puerto Rico","disabled":"n"},{"value":"QAT","title":"Qatar","disabled":"n"},{"value":"ROM","title":"Romania","disabled":"n"},{"value":"RUS","title":"Russia","disabled":"n"},{"value":"RWA","title":"Rwanda","disabled":"n"},{"value":"KNA","title":"Saint Kitts and Nevis","disabled":"n"},{"value":"LCA","title":"Saint Lucia","disabled":"n"},{"value":"VCT","title":"Saint Vincent and the Grenadines","disabled":"n"},{"value":"WSM","title":"Samoa","disabled":"n"},{"value":"SMR","title":"San Marino","disabled":"n"},{"value":"STP","title":"Sao Tome and Principe","disabled":"n"},{"value":"SAU","title":"Saudi Arabia","disabled":"n"},{"value":"SEN","title":"Senegal","disabled":"n"},{"value":"SRB","title":"Serbia","disabled":"n"},{"value":"SYC","title":"Seychelles","disabled":"n"},{"value":"SLE","title":"Sierra Leone","disabled":"n"},{"value":"SGP","title":"Singapore","disabled":"n"},{"value":"SVK","title":"Slovakia","disabled":"n"},{"value":"SVN","title":"Slovenia","disabled":"n"},{"value":"SLB","title":"Solomon Islands","disabled":"n"},{"value":"SOM","title":"Somalia","disabled":"n"},{"value":"ZAF","title":"South Africa","disabled":"n"},{"value":"SGS","title":"South Georgia and the South Sandwich Islands","disabled":"n"},{"value":"ESP","title":"Spain","disabled":"n"},{"value":"LKA","title":"Sri Lanka","disabled":"n"},{"value":"SHN","title":"St. Helena","disabled":"n"},{"value":"SPM","title":"St. Pierre and Miquelon","disabled":"n"},{"value":"SDN","title":"Sudan","disabled":"n"},{"value":"SUR","title":"Suriname","disabled":"n"},{"value":"SJM","title":"Svalbard and Jan Mayen Islands","disabled":"n"},{"value":"SWZ","title":"Swaziland","disabled":"n"},{"value":"SWE","title":"Sweden","disabled":"n"},{"value":"CHE","title":"Switzerland","disabled":"n"},{"value":"SYR","title":"Syrian Arab Republic","disabled":"n"},{"value":"TWN","title":"Taiwan","disabled":"n"},{"value":"TJK","title":"Tajikistan","disabled":"n"},{"value":"TZA","title":"Tanzania","disabled":"n"},{"value":"THA","title":"Thailand","disabled":"n"},{"value":"TGO","title":"Togo","disabled":"n"},{"value":"TKL","title":"Tokelau","disabled":"n"},{"value":"TON","title":"Tonga","disabled":"n"},{"value":"TTO","title":"Trinidad and Tobago","disabled":"n"},{"value":"TUN","title":"Tunisia","disabled":"n"},{"value":"TUR","title":"Turkey","disabled":"n"},{"value":"TKM","title":"Turkmenistan","disabled":"n"},{"value":"TCA","title":"Turks and Caicos Islands","disabled":"n"},{"value":"TUV","title":"Tuvalu","disabled":"n"},{"value":"UGA","title":"Uganda","disabled":"n"},{"value":"UKR","title":"Ukraine","disabled":"n"},{"value":"ARE","title":"United Arab Emirates","disabled":"n"},{"value":"GBR","title":"United Kingdom","disabled":"n"},{"value":"UMI","title":"United States Minor Outlying Islands","disabled":"n"},{"value":"USA","title":"United States of America","disabled":"n"},{"value":"URY","title":"Uruguay","disabled":"n"},{"value":"UZB","title":"Uzbekistan","disabled":"n"},{"value":"VUT","title":"Vanuatu","disabled":"n"},{"value":"VAT","title":"Vatican City State","disabled":"n"},{"value":"VEN","title":"Venezuela","disabled":"n"},{"value":"VNM","title":"Vietnam","disabled":"n"},{"value":"VGB","title":"Virgin Islands (British)","disabled":"n"},{"value":"VIR","title":"Virgin Islands (U.S.)","disabled":"n"},{"value":"WLF","title":"Wallis and Futuna Islands","disabled":"n"},{"value":"ESH","title":"Western Sahara","disabled":"n"},{"value":"YEM","title":"Yemen","disabled":"n"},{"value":"YUG","title":"Yugoslavia","disabled":"n"},{"value":"ZAR","title":"Zaire","disabled":"n"},{"value":"ZMB","title":"Zambia","disabled":"n"},{"value":"ZWE","title":"Zimbabwe","disabled":"n"}]
```

### US states fields

To create a US state field, first create a **new field** in AcyMailing.\
Then access your **database** (using phpMyAdmin for example), select the table "**#\_\_acym\_field**" and edit the field you just created.\
In the textarea **value**, copy paste the following code:

```javascript
[{"value":"AL","title":"Alabama","disabled":"n"},{"value":"AK","title":"Alaska","disabled":"n"},{"value":"AZ","title":"Arizona","disabled":"n"},{"value":"AR","title":"Arkansas","disabled":"n"},{"value":"CA","title":"California","disabled":"n"},{"value":"CO","title":"Colorado","disabled":"n"},{"value":"CT","title":"Connecticut","disabled":"n"},{"value":"DE","title":"Delaware","disabled":"n"},{"value":"DC","title":"District of Columbia","disabled":"n"},{"value":"FL","title":"Florida","disabled":"n"},{"value":"GA","title":"Georgia","disabled":"n"},{"value":"HI","title":"Hawaii","disabled":"n"},{"value":"ID","title":"Idaho","disabled":"n"},{"value":"IL","title":"Illinois","disabled":"n"},{"value":"IN","title":"Indiana","disabled":"n"},{"value":"IA","title":"Iowa","disabled":"n"},{"value":"KS","title":"Kansas","disabled":"n"},{"value":"KY","title":"Kentucky","disabled":"n"},{"value":"LA","title":"Louisiana","disabled":"n"},{"value":"ME","title":"Maine","disabled":"n"},{"value":"MT","title":"Montana","disabled":"n"},{"value":"NE","title":"Nebraska","disabled":"n"},{"value":"NV","title":"Nevada","disabled":"n"},{"value":"NH","title":"New Hampshire","disabled":"n"},{"value":"NJ","title":"New Jersey","disabled":"n"},{"value":"NM","title":"New Mexico","disabled":"n"},{"value":"NY","title":"New York","disabled":"n"},{"value":"NC","title":"North Carolina","disabled":"n"},{"value":"ND","title":"North Dakota","disabled":"n"},{"value":"OH","title":"Ohio","disabled":"n"},{"value":"OK","title":"Oklahoma","disabled":"n"},{"value":"OR","title":"Oregon","disabled":"n"},{"value":"MD","title":"Maryland","disabled":"n"},{"value":"MA","title":"Massachusetts","disabled":"n"},{"value":"MI","title":"Michigan","disabled":"n"},{"value":"MN","title":"Minnesota","disabled":"n"},{"value":"MS","title":"Mississippi","disabled":"n"},{"value":"MO","title":"Missouri","disabled":"n"},{"value":"PA","title":"Pennsylvania","disabled":"n"},{"value":"RI","title":"Rhode Island","disabled":"n"},{"value":"SC","title":"South Carolina","disabled":"n"},{"value":"SD","title":"South Dakota","disabled":"n"},{"value":"TN","title":"Tennessee","disabled":"n"},{"value":"TX","title":"Texas","disabled":"n"},{"value":"UT","title":"Utah","disabled":"n"},{"value":"VT","title":"Vermont","disabled":"n"},{"value":"VA","title":"Virginia","disabled":"n"},{"value":"WA","title":"Washington","disabled":"n"},{"value":"WV","title":"West Virginia","disabled":"n"},{"value":"WI","title":"Wisconsin","disabled":"n"},{"value":"WY","title":"Wyoming","disabled":"n"}]
```

### Canada Provinces field

To create a Canada provinces field, first create a **new field** in AcyMailing.\
Then access your **database** (using phpMyAdmin for example), select the table "**#\_\_acym\_field**" and edit the field you just created.\
In the textarea **value**, copy paste the following code:

```javascript
[{"value":"N/A","title":"N/A","disabled":"n"},{"value":"AB","title":"Alberta","disabled":"n"},{"value":"BC","title":"BritishColumbia","disabled":"n"},{"value":"MB","title":"Manitoba","disabled":"n"},{"value":"NB","title":"NewBrunswick","disabled":"n"},{"value":"NL","title":"NewfoundlandandLabrador","disabled":"n"},{"value":"NT","title":"NorthwestTerritories","disabled":"n"},{"value":"NS","title":"NovaScotia","disabled":"n"},{"value":"NU","title":"Nunavut","disabled":"n"},{"value":"ON","title":"Ontario","disabled":"n"},{"value":"PE","title":"PrinceEdwardIsland","disabled":"n"},{"value":"QC","title":"Quebec","disabled":"n"},{"value":"SK","title":"Saskatchewan","disabled":"n"},{"value":"YT","title":"Yukon","disabled":"n"}]
```

### Brazilian states field

To create a Brazilian states field, first create a **new field** in AcyMailing.\
Then access your **database** (using phpMyAdmin for example), select the table "**#\_\_acym\_field**" and edit the field you just created.\
In the textarea **value**, copy paste the following code:

```javascript
[{"value":"AC","title":"Acre","disabled":"n"},{"value":"AL","title":"Alagoas","disabled":"n"},{"value":"AP","title":"Amapá","disabled":"n"},{"value":"AM","title":"Amazonas","disabled":"n"},{"value":"BA","title":"Bahia","disabled":"n"},{"value":"CE","title":"Ceará","disabled":"n"},{"value":"DF","title":"DistritoFederal","disabled":"n"},{"value":"ES","title":"EspíritoSanto","disabled":"n"},{"value":"GO","title":"Goiás","disabled":"n"},{"value":"MA","title":"Maranhão","disabled":"n"},{"value":"MT","title":"MatoGrosso","disabled":"n"},{"value":"MS","title":"MatoGrossodoSul","disabled":"n"},{"value":"MG","title":"MinasGerais","disabled":"n"},{"value":"PA","title":"Pará","disabled":"n"},{"value":"PB","title":"Paraíba","disabled":"n"},{"value":"PR","title":"Paraná","disabled":"n"},{"value":"PE","title":"Pernambuco","disabled":"n"},{"value":"PI","title":"Piauí","disabled":"n"},{"value":"RJ","title":"RiodeJaneiro","disabled":"n"},{"value":"RN","title":"RioGrandedoNorte","disabled":"n"},{"value":"RS","title":"RioGrandedoSul","disabled":"n"},{"value":"RO","title":"Rondônia","disabled":"n"},{"value":"RR","title":"Roraima","disabled":"n"},{"value":"SC","title":"SantaCatarina","disabled":"n"},{"value":"SP","title":"SãoPaulo","disabled":"n"},{"value":"SE","title":"Sergipe","disabled":"n"},{"value":"TO","title":"Tocantins","disabled":"n"}]
```

### Australian States field

To create a Australian states field, first create a **new field** in AcyMailing.\
Then access your **database** (using phpMyAdmin for example), select the table "**#\_\_acym\_field**" and edit the field you just created.\
In the textarea **value**, copy paste the following code:

```javascript
[{"value":"ACT","title":"Australian Capital Territory","disabled":"n"},{"value":"NSW","title":"New South Wales","disabled":"n"},{"value":"NT","title":"Northern Territory","disabled":"n"},{"value":"QLD","title":"Queensland","disabled":"n"},{"value":"SA","title":"South Australia","disabled":"n"},{"value":"TAS","title":"Tasmania","disabled":"n"},{"value":"VIC","title":"Victoria","disabled":"n"},{"value":"WA","title":"Western Australia","disabled":"n"}]
```


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.acymailing.com/main-pages/custom-fields/samples.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.