Contributors:
currencies
This component renders a form select element of all currency names, codes and symbols by default, and can also be used to output currency data to a Liquid collection.
{% component type: "currencies" %}
Parameters and Options
Parameter
Values
Required
Description
type
currenciesThis is the name of the entity that needs to be used for the component retrieving function.
layout
<path/to/layout>Path to file that will contain the Liquid layout content to be parsed.
If an empty string, nothing will be rendered.
If paramater is not included, the default virtual layout will be rendered (see below).
collectionVariable
<yourLiquidVariableName>Assigns the data to a Liquid collection enabling further access to the data on the Page or Template using Liquid.
Your collectionVariable value must only contain English letters, numbers or underscores. Spaces or special characters are not supported.
Liquid Output
The below output shows the list of currency data:
{
"Items": [
{
"Code": "AED",
"Sign": "د.إ",
"DigitalCode": "784",
"Name": "UAE Dirham",
"Params": {}
},
{
"Code": "AFN",
"Sign": "Af",
"DigitalCode": "971",
"Name": "Afghani",
"Params": {}
},
{
"Code": "ALL",
"Sign": "L",
"DigitalCode": "8",
"Name": "Lek",
"Params": {}
},
{
"Code": "AMD",
"Sign": "Դ",
"DigitalCode": "51",
"Name": "Armenian Dram",
"Params": {}
},
{
"Code": "AOA",
"Sign": "Kz",
"DigitalCode": "973",
"Name": "Kwanza",
"Params": {}
},
{
"Code": "ARS",
"Sign": "$",
"DigitalCode": "32",
"Name": "Argentine Peso",
"Params": {}
},
{
"Code": "AUD",
"Sign": "$",
"DigitalCode": "36",
"Name": "Australian Dollar",
"Params": {}
},
{
"Code": "AWG",
"Sign": "ƒ",
"DigitalCode": "533",
"Name": "Aruban Guilder/Florin",
"Params": {}
},
{
"Code": "AZN",
"Sign": "ман",
"DigitalCode": "944",
"Name": "Azerbaijanian Manat",
"Params": {}
},
{
"Code": "BAM",
"Sign": "КМ",
"DigitalCode": "977",
"Name": "Konvertibilna Marka",
"Params": {}
},
{
"Code": "BBD",
"Sign": "$",
"DigitalCode": "52",
"Name": "Barbados Dollar",
"Params": {}
},
{
"Code": "BDT",
"Sign": "৳",
"DigitalCode": "50",
"Name": "Taka",
"Params": {}
},
{
"Code": "BGN",
"Sign": "лв",
"DigitalCode": "975",
"Name": "Bulgarian Lev",
"Params": {}
},
{
"Code": "BHD",
"Sign": "ب.د",
"DigitalCode": "48",
"Name": "Bahraini Dinar",
"Params": {}
},
{
"Code": "BIF",
"Sign": "₣",
"DigitalCode": "108",
"Name": "Burundi Franc",
"Params": {}
},
{
"Code": "BMD",
"Sign": "$",
"DigitalCode": "60",
"Name": "Bermudian Dollar",
"Params": {}
},
{
"Code": "BND",
"Sign": "$",
"DigitalCode": "96",
"Name": "Brunei Dollar",
"Params": {}
},
{
"Code": "BOB",
"Sign": "Bs.",
"DigitalCode": "68",
"Name": "Boliviano",
"Params": {}
},
{
"Code": "BRL",
"Sign": "R$",
"DigitalCode": "986",
"Name": "Brazilian Real",
"Params": {}
},
{
"Code": "BSD",
"Sign": "$",
"DigitalCode": "44",
"Name": "Bahamian Dollar",
"Params": {}
},
{
"Code": "BTN",
"Sign": "",
"DigitalCode": "64",
"Name": "Ngultrum",
"Params": {}
},
{
"Code": "BWP",
"Sign": "P",
"DigitalCode": "72",
"Name": "Pula",
"Params": {}
},
{
"Code": "BYR",
"Sign": "Br",
"DigitalCode": "974",
"Name": "Belarussian Ruble",
"Params": {}
},
{
"Code": "BZD",
"Sign": "$",
"DigitalCode": "84",
"Name": "Belize Dollar",
"Params": {}
},
{
"Code": "CAD",
"Sign": "$",
"DigitalCode": "124",
"Name": "Canadian Dollar",
"Params": {}
},
{
"Code": "CDF",
"Sign": "₣",
"DigitalCode": "976",
"Name": "Congolese Franc",
"Params": {}
},
{
"Code": "CHF",
"Sign": "₣",
"DigitalCode": "756",
"Name": "Swiss Franc",
"Params": {}
},
{
"Code": "CLP",
"Sign": "$",
"DigitalCode": "152",
"Name": "Chilean Peso",
"Params": {}
},
{
"Code": "CNY",
"Sign": "¥",
"DigitalCode": "156",
"Name": "Yuan",
"Params": {}
},
{
"Code": "COP",
"Sign": "$",
"DigitalCode": "170",
"Name": "Colombian Peso",
"Params": {}
},
{
"Code": "CRC",
"Sign": "₡",
"DigitalCode": "188",
"Name": "Costa Rican Colon",
"Params": {}
},
{
"Code": "CUP",
"Sign": "$",
"DigitalCode": "192",
"Name": "Cuban Peso",
"Params": {}
},
{
"Code": "CVE",
"Sign": "$",
"DigitalCode": "132",
"Name": "Cape Verde Escudo",
"Params": {}
},
{
"Code": "CZK",
"Sign": "Kč",
"DigitalCode": "203",
"Name": "Czech Koruna",
"Params": {}
},
{
"Code": "DJF",
"Sign": "₣",
"DigitalCode": "262",
"Name": "Djibouti Franc",
"Params": {}
},
{
"Code": "DKK",
"Sign": "kr",
"DigitalCode": "208",
"Name": "Danish Krone",
"Params": {}
},
{
"Code": "DOP",
"Sign": "$",
"DigitalCode": "214",
"Name": "Dominican Peso",
"Params": {}
},
{
"Code": "DZD",
"Sign": "د.ج",
"DigitalCode": "12",
"Name": "Algerian Dinar",
"Params": {}
},
{
"Code": "EGP",
"Sign": "£",
"DigitalCode": "818",
"Name": "Egyptian Pound",
"Params": {}
},
{
"Code": "ERN",
"Sign": "Nfk",
"DigitalCode": "232",
"Name": "Nakfa",
"Params": {}
},
{
"Code": "ETB",
"Sign": "",
"DigitalCode": "230",
"Name": "Ethiopian Birr",
"Params": {}
},
{
"Code": "EUR",
"Sign": "€",
"DigitalCode": "978",
"Name": "Euro",
"Params": {}
},
{
"Code": "FJD",
"Sign": "$",
"DigitalCode": "242",
"Name": "Fiji Dollar",
"Params": {}
},
{
"Code": "FKP",
"Sign": "£",
"DigitalCode": "238",
"Name": "Falkland Islands Pound",
"Params": {}
},
{
"Code": "GBP",
"Sign": "£",
"DigitalCode": "826",
"Name": "Pound Sterling",
"Params": {}
},
{
"Code": "GEL",
"Sign": "ლ",
"DigitalCode": "981",
"Name": "Lari",
"Params": {}
},
{
"Code": "GHS",
"Sign": "₵",
"DigitalCode": "936",
"Name": "Cedi",
"Params": {}
},
{
"Code": "GIP",
"Sign": "£",
"DigitalCode": "292",
"Name": "Gibraltar Pound",
"Params": {}
},
{
"Code": "GMD",
"Sign": "D",
"DigitalCode": "270",
"Name": "Dalasi",
"Params": {}
},
{
"Code": "GNF",
"Sign": "₣",
"DigitalCode": "324",
"Name": "Guinea Franc",
"Params": {}
},
{
"Code": "GTQ",
"Sign": "Q",
"DigitalCode": "320",
"Name": "Quetzal",
"Params": {}
},
{
"Code": "GYD",
"Sign": "$",
"DigitalCode": "328",
"Name": "Guyana Dollar",
"Params": {}
},
{
"Code": "HKD",
"Sign": "$",
"DigitalCode": "344",
"Name": "Hong Kong Dollar",
"Params": {}
},
{
"Code": "HNL",
"Sign": "L",
"DigitalCode": "340",
"Name": "Lempira",
"Params": {}
},
{
"Code": "HRK",
"Sign": "Kn",
"DigitalCode": "191",
"Name": "Croatian Kuna",
"Params": {}
},
{
"Code": "HTG",
"Sign": "G",
"DigitalCode": "332",
"Name": "Gourde",
"Params": {}
},
{
"Code": "HUF",
"Sign": "Ft",
"DigitalCode": "348",
"Name": "Forint",
"Params": {}
},
{
"Code": "IDR",
"Sign": "Rp",
"DigitalCode": "360",
"Name": "Rupiah",
"Params": {}
},
{
"Code": "ILS",
"Sign": "₪",
"DigitalCode": "376",
"Name": "New Israeli Shekel",
"Params": {}
},
{
"Code": "INR",
"Sign": "₹",
"DigitalCode": "356",
"Name": "Indian Rupee",
"Params": {}
},
{
"Code": "IQD",
"Sign": "ع.د",
"DigitalCode": "368",
"Name": "Iraqi Dinar",
"Params": {}
},
{
"Code": "IRR",
"Sign": "﷼",
"DigitalCode": "364",
"Name": "Iranian Rial",
"Params": {}
},
{
"Code": "ISK",
"Sign": "Kr",
"DigitalCode": "352",
"Name": "Iceland Krona",
"Params": {}
},
{
"Code": "JMD",
"Sign": "$",
"DigitalCode": "388",
"Name": "Jamaican Dollar",
"Params": {}
},
{
"Code": "JOD",
"Sign": "د.ا",
"DigitalCode": "400",
"Name": "Jordanian Dinar",
"Params": {}
},
{
"Code": "JPY",
"Sign": "¥",
"DigitalCode": "392",
"Name": "Yen",
"Params": {}
},
{
"Code": "KES",
"Sign": "Sh",
"DigitalCode": "404",
"Name": "Kenyan Shilling",
"Params": {}
},
{
"Code": "KGS",
"Sign": "",
"DigitalCode": "417",
"Name": "Som",
"Params": {}
},
{
"Code": "KHR",
"Sign": "៛",
"DigitalCode": "116",
"Name": "Riel",
"Params": {}
},
{
"Code": "KPW",
"Sign": "₩",
"DigitalCode": "408",
"Name": "North Korean Won",
"Params": {}
},
{
"Code": "KRW",
"Sign": "₩",
"DigitalCode": "410",
"Name": "South Korean Won",
"Params": {}
},
{
"Code": "KWD",
"Sign": "د.ك",
"DigitalCode": "414",
"Name": "Kuwaiti Dinar",
"Params": {}
},
{
"Code": "KYD",
"Sign": "$",
"DigitalCode": "136",
"Name": "Cayman Islands Dollar",
"Params": {}
},
{
"Code": "KZT",
"Sign": "〒",
"DigitalCode": "398",
"Name": "Tenge",
"Params": {}
},
{
"Code": "LAK",
"Sign": "₭",
"DigitalCode": "418",
"Name": "Kip",
"Params": {}
},
{
"Code": "LBP",
"Sign": "ل.ل",
"DigitalCode": "422",
"Name": "Lebanese Pound",
"Params": {}
},
{
"Code": "LKR",
"Sign": "Rs",
"DigitalCode": "144",
"Name": "Sri Lanka Rupee",
"Params": {}
},
{
"Code": "LRD",
"Sign": "$",
"DigitalCode": "430",
"Name": "Liberian Dollar",
"Params": {}
},
{
"Code": "LSL",
"Sign": "L",
"DigitalCode": "426",
"Name": "Loti",
"Params": {}
},
{
"Code": "LYD",
"Sign": "ل.د",
"DigitalCode": "434",
"Name": "Libyan Dinar",
"Params": {}
},
{
"Code": "MAD",
"Sign": "د.م.",
"DigitalCode": "504",
"Name": "Moroccan Dirham",
"Params": {}
},
{
"Code": "MDL",
"Sign": "L",
"DigitalCode": "498",
"Name": "Moldavian Leu",
"Params": {}
},
{
"Code": "MGA",
"Sign": "",
"DigitalCode": "969",
"Name": "Malagasy Ariary",
"Params": {}
},
{
"Code": "MKD",
"Sign": "ден",
"DigitalCode": "807",
"Name": "Denar",
"Params": {}
},
{
"Code": "MMK",
"Sign": "K",
"DigitalCode": "104",
"Name": "Kyat",
"Params": {}
},
{
"Code": "MNT",
"Sign": "₮",
"DigitalCode": "496",
"Name": "Tugrik",
"Params": {}
},
{
"Code": "MOP",
"Sign": "P",
"DigitalCode": "446",
"Name": "Pataca",
"Params": {}
},
{
"Code": "MRO",
"Sign": "UM",
"DigitalCode": "478",
"Name": "Ouguiya",
"Params": {}
},
{
"Code": "MUR",
"Sign": "₨",
"DigitalCode": "480",
"Name": "Mauritius Rupee",
"Params": {}
},
{
"Code": "MVR",
"Sign": "ރ.",
"DigitalCode": "462",
"Name": "Rufiyaa",
"Params": {}
},
{
"Code": "MWK",
"Sign": "MK",
"DigitalCode": "454",
"Name": "Kwacha",
"Params": {}
},
{
"Code": "MXN",
"Sign": "$",
"DigitalCode": "484",
"Name": "Mexican Peso",
"Params": {}
},
{
"Code": "MYR",
"Sign": "RM",
"DigitalCode": "458",
"Name": "Malaysian Ringgit",
"Params": {}
},
{
"Code": "MZN",
"Sign": "MTn",
"DigitalCode": "943",
"Name": "Metical",
"Params": {}
},
{
"Code": "NAD",
"Sign": "$",
"DigitalCode": "516",
"Name": "Namibia Dollar",
"Params": {}
},
{
"Code": "NGN",
"Sign": "₦",
"DigitalCode": "566",
"Name": "Naira",
"Params": {}
},
{
"Code": "NIO",
"Sign": "C$",
"DigitalCode": "558",
"Name": "Cordoba Oro",
"Params": {}
},
{
"Code": "NOK",
"Sign": "kr",
"DigitalCode": "578",
"Name": "Norwegian Krone",
"Params": {}
},
{
"Code": "NPR",
"Sign": "₨",
"DigitalCode": "524",
"Name": "Nepalese Rupee",
"Params": {}
},
{
"Code": "NZD",
"Sign": "$",
"DigitalCode": "554",
"Name": "New Zealand Dollar",
"Params": {}
},
{
"Code": "OMR",
"Sign": "ر.ع.",
"DigitalCode": "512",
"Name": "Rial Omani",
"Params": {}
},
{
"Code": "PAB",
"Sign": "B/.",
"DigitalCode": "590",
"Name": "Balboa",
"Params": {}
},
{
"Code": "PEN",
"Sign": "S/.",
"DigitalCode": "604",
"Name": "Nuevo Sol",
"Params": {}
},
{
"Code": "PGK",
"Sign": "K",
"DigitalCode": "598",
"Name": "Kina",
"Params": {}
},
{
"Code": "PHP",
"Sign": "₱",
"DigitalCode": "608",
"Name": "Philippine Peso",
"Params": {}
},
{
"Code": "PKR",
"Sign": "₨",
"DigitalCode": "586",
"Name": "Pakistan Rupee",
"Params": {}
},
{
"Code": "PLN",
"Sign": "zł",
"DigitalCode": "985",
"Name": "PZloty",
"Params": {}
},
{
"Code": "PYG",
"Sign": "₲",
"DigitalCode": "600",
"Name": "Guarani",
"Params": {}
},
{
"Code": "QAR",
"Sign": "ر.ق",
"DigitalCode": "634",
"Name": "Qatari Rial",
"Params": {}
},
{
"Code": "RON",
"Sign": "L",
"DigitalCode": "946",
"Name": "Leu",
"Params": {}
},
{
"Code": "RSD",
"Sign": "din",
"DigitalCode": "941",
"Name": "Serbian Dinar",
"Params": {}
},
{
"Code": "RUB",
"Sign": "р.",
"DigitalCode": "643",
"Name": "Russian Ruble",
"Params": {}
},
{
"Code": "RWF",
"Sign": "₣",
"DigitalCode": "646",
"Name": "Rwanda Franc",
"Params": {}
},
{
"Code": "SAR",
"Sign": "ر.س",
"DigitalCode": "682",
"Name": "Saudi Riyal",
"Params": {}
},
{
"Code": "SBD",
"Sign": "$",
"DigitalCode": "90",
"Name": "Solomon Islands Dollar",
"Params": {}
},
{
"Code": "SCR",
"Sign": "₨",
"DigitalCode": "690",
"Name": "Seychelles Rupee",
"Params": {}
},
{
"Code": "SDG",
"Sign": "£",
"DigitalCode": "938",
"Name": "Sudanese Pound",
"Params": {}
},
{
"Code": "SEK",
"Sign": "kr",
"DigitalCode": "752",
"Name": "Swedish Krona",
"Params": {}
},
{
"Code": "SGD",
"Sign": "$",
"DigitalCode": "702",
"Name": "Singapore Dollar",
"Params": {}
},
{
"Code": "SHP",
"Sign": "£",
"DigitalCode": "654",
"Name": "Saint Helena Pound",
"Params": {}
},
{
"Code": "SLL",
"Sign": "Le",
"DigitalCode": "694",
"Name": "Leone",
"Params": {}
},
{
"Code": "SOS",
"Sign": "Sh",
"DigitalCode": "706",
"Name": "Somali Shilling",
"Params": {}
},
{
"Code": "SRD",
"Sign": "$",
"DigitalCode": "968",
"Name": "Suriname Dollar",
"Params": {}
},
{
"Code": "STD",
"Sign": "Db",
"DigitalCode": "678",
"Name": "Dobra",
"Params": {}
},
{
"Code": "SYP",
"Sign": "ل.س",
"DigitalCode": "760",
"Name": "Syrian Pound",
"Params": {}
},
{
"Code": "SZL",
"Sign": "L",
"DigitalCode": "748",
"Name": "Lilangeni",
"Params": {}
},
{
"Code": "THB",
"Sign": "฿",
"DigitalCode": "764",
"Name": "Baht",
"Params": {}
},
{
"Code": "TJS",
"Sign": "ЅМ",
"DigitalCode": "972",
"Name": "Somoni",
"Params": {}
},
{
"Code": "TMT",
"Sign": "m",
"DigitalCode": "934",
"Name": "Manat",
"Params": {}
},
{
"Code": "TND",
"Sign": "د.ت",
"DigitalCode": "788",
"Name": "Tunisian Dinar",
"Params": {}
},
{
"Code": "TOP",
"Sign": "T$",
"DigitalCode": "776",
"Name": "Pa’anga",
"Params": {}
},
{
"Code": "TRY",
"Sign": "₤",
"DigitalCode": "949",
"Name": "Turkish Lira",
"Params": {}
},
{
"Code": "TTD",
"Sign": "$",
"DigitalCode": "780",
"Name": "Trinidad and Tobago Dollar",
"Params": {}
},
{
"Code": "TWD",
"Sign": "$",
"DigitalCode": "901",
"Name": "Taiwan Dollar",
"Params": {}
},
{
"Code": "TZS",
"Sign": "Sh",
"DigitalCode": "834",
"Name": "Tanzanian Shilling",
"Params": {}
},
{
"Code": "UAH",
"Sign": "₴",
"DigitalCode": "980",
"Name": "Hryvnia",
"Params": {}
},
{
"Code": "UGX",
"Sign": "Sh",
"DigitalCode": "800",
"Name": "Uganda Shilling",
"Params": {}
},
{
"Code": "USD",
"Sign": "$",
"DigitalCode": "840",
"Name": "US Dollar",
"Params": {}
},
{
"Code": "UYU",
"Sign": "$",
"DigitalCode": "858",
"Name": "Peso Uruguayo",
"Params": {}
},
{
"Code": "UZS",
"Sign": "",
"DigitalCode": "860",
"Name": "Uzbekistan Sum",
"Params": {}
},
{
"Code": "VEF",
"Sign": "Bs F",
"DigitalCode": "937",
"Name": "Bolivar Fuerte",
"Params": {}
},
{
"Code": "VND",
"Sign": "₫",
"DigitalCode": "704",
"Name": "Dong",
"Params": {}
},
{
"Code": "VUV",
"Sign": "Vt",
"DigitalCode": "548",
"Name": "Vatu",
"Params": {}
},
{
"Code": "WST",
"Sign": "T",
"DigitalCode": "882",
"Name": "Tala",
"Params": {}
},
{
"Code": "XAF",
"Sign": "₣",
"DigitalCode": "950",
"Name": "CFA Franc BCEAO",
"Params": {}
},
{
"Code": "XCD",
"Sign": "$",
"DigitalCode": "951",
"Name": "East Caribbean Dollar",
"Params": {}
},
{
"Code": "XPF",
"Sign": "₣",
"DigitalCode": "953",
"Name": "CFP Franc",
"Params": {}
},
{
"Code": "YER",
"Sign": "﷼",
"DigitalCode": "886",
"Name": "Yemeni Rial",
"Params": {}
},
{
"Code": "ZAR",
"Sign": "R",
"DigitalCode": "710",
"Name": "Rand",
"Params": {}
},
{
"Code": "ZMW",
"Sign": "ZK",
"DigitalCode": "967",
"Name": "Zambian Kwacha",
"Params": {}
},
{
"Code": "ZWL",
"Sign": "$",
"DigitalCode": "932",
"Name": "Zimbabwe Dollar",
"Params": {}
},
{
"Code": "ANG",
"Sign": "NAƒ",
"DigitalCode": "532",
"Name": "Netherlands Antillean Guilder",
"Params": {}
},
{
"Code": "XOF",
"Sign": "CFA",
"DigitalCode": "952",
"Name": "West African CFA franc",
"Params": {}
},
{
"Code": "KMF",
"Sign": "CF",
"DigitalCode": "174",
"Name": "Comorian franc",
"Params": {}
}
],
"Params": {
"type": "currencies",
"layout": "",
"collectionvariable": "currencyCollection"
}
}Virtual Layout
If not using any custom layout or collection, the default virtual layout will output as a form select element:
<select>
{% for item in this.items %}
<option value="{{item.Code}}">{{item.Name}} ({{item.Symbol}})</option>
{% endfor %}
</select>
Accessing the Data
JSON Output
You can output the full JSON for your component data by referencing the root Liquid object {{this}} in your module’s layouts, or directly on your page, if using the collectionVariable parameter in your component tag.
For example:
{% component type: ... collectionVariable: "myData" %}
You can then render the JSON like so:
{{myData}}
For more details on using this approach, see Part 2 of the free ‘Learning Liquid Course’.
Rendering Property Values
This data is also accessible directly on the Page or Template via a Liquid Collection by adding collectionVariable to the Component.
An example using collectionVariable with value "currencyCollection":
{% component type: "currencies", collectionVariable: "currencyCollection" %}
Accessing a specific item within the collection. In this case the third item (zero based index), which in our example would render the value Lek
{{currencyCollection.items[2]['name']}}