Troubleshooting¶

The field shows a code instead of a name¶

The formatter shows the alphabetic code by default. At Manage display, set the formatter's Show setting to Currency name or Country name.

It has been withdrawn from ISO 4217, for example HRK after Croatia adopted the euro. Existing values stay valid and selectable on the items that store them. New values should use the replacement currency. See Currency data for the list of recent changes.

Saving fails with "is not an ISO 4217 currency code"¶

The value is not an alphabetic code in currencies.yml. Codes are upper case: usd is rejected. Check values set by migrations, imports and API clients.

Country names for shared currencies¶

With Country name selected, a currency used by several entities is labelled with one of them: EUR shows "Spain" and USD shows "Virgin Islands (U.s.)", the last entity in the ISO list for each. Use Currency name or Alphabetic code for fields where shared currencies are likely. Better labels for these currencies are tracked in the issue queue.

An optional field saved Afghani (AFN) without anyone choosing it¶

Before 2.1.0, the widget had no empty option, so the browser preselected the first currency and every save of an optional field stored AFN. Update the module, then look for unintended AFN values, for example with a view filtered on the field.

Kernel tests fail with "settings.display missing schema"¶

Releases up to 2.0.0 shipped no configuration schema for the field's storage setting. Update the module.