--- sourceDocument: Xanadu ServiceNow AI Platform Administration sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/xanadu/platform-administration Release : - xanadu ft:locale : - en-US ft:publication_title : - Xanadu ServiceNow AI Platform Administration ft:clusterId : - platadm bundleId : - platadm workflow : - Platform --- # Configuring FX Currency global settings # Configuring FX Currency global settings {#ariaid-title1} * Release version: Xanadu * * Updated August 1, 2024 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 2 minutes to read Before setting up and using FX Currency, review the related system properties to confirm or modify its default behavior. ## Before you begin Role required: admin ## About this task The global defaults you establish in system properties apply the configuration option to all FX Currency fields. You can then customize them for specific dictionary attributes in System LocalizationFX Currency Configuration. When you create a currency configuration, it applies those settings only to the FX Currency field that you add it to. To learn more about FX Currency configurations, see [Configuring FX Currency field behavior](https://servicenow-prod.fluidtopics.net/qK7lN0TKzVNY9eYTRS1nHA "After establishing global currency defaults, you can create custom FX Currency configurations for specific table fields. Identify the table fields that use FX Currency, and define how currency conversion calculations should be performed, displayed, filtered, and aggregated."). FX Currency configuration settings for specific FX Currency fields take precedence over system properties. Administrators can set a global configuration for a property, and then apply exceptions on a field-by-field basis. * If you change system defaults, except for display_digits and display_value, the changes apply to updated and new values only. * Existing values and data don't change but rather display differently, depending on configuration. {#fx-currency-configure__ul_bdv_zxm_1kb} Important: Don't edit the Currency \[fx_currency\] table directly. The system maintains this table and your changes could have unintended consequences. ## Procedure 1. Navigate to AllSystem LocalizationFX Currency Configuration. 2. Review the system defaults and make any desired changes. {#fx-currency-configure__table_j32_npz_xjb__entry__3} | System property | FX Currency configuration mapping | Description | |:-|:-:|:-| | glide.currency2.display_digits | currency_display_digits | Default number of digits displayed in FX Currency fields. Note: In a form, FX Currency fields display the number of digits you enter, up to 12 digits in length. * Type: Number * Default value: -1, or currency default * Available options: 0--12 * Develop: [GlideCurrencyFormatter](https://developer.servicenow.com/go_to_api.do?ID=GlideCurrencyFormatterScopedAPI&v=kingston) {#fx-currency-configure__ul_n3c_xpz_xjb} | | glide.currency2.display_value | currency_display_value | Default currency display value returned from getDisplayValue(). * Type: String * Default value: as_entered * Available options: * as_entered: Currency value as entered by the user * in_session_currency: Currency value as entered by the user and converted to the session currency * in_reference_currency: Currency value as entered by the user converted to the reference currency {#fx-currency-configure__ul_cjc_xpz_xjb} * Develop: [GlideCurrencyFormatter](https://developer.servicenow.com/go_to_api.do?ID=GlideCurrencyFormatterScopedAPI&v=kingston) {#fx-currency-configure__ul_bjc_xpz_xjb} | | glide.currency2.system_rate_table | conversion_rate_table | Conversion rate table used to perform currency conversions. By default, the source for currency conversions is the System Currency Conversion Rate \[fx_system_rate\] table, which stores the daily reference rates retrieved from the European Central Bank. If you have defined a custom rate table, you can change the rate table used in currency conversions. * Type: String * Default value: fx_system_rate * Available options: Any table that extends the Currency Conversion Rate table \[fx_conversion_rate\] * Learn more: [Understanding how FX Currency field conversions work](https://servicenow-prod.fluidtopics.net/zppfzOFo~SHnxl7w6MzRyg "You can use existing system currency rates or define a custom conversion rate table for use in FX Currency processing.")and [Default currency conversions](https://servicenow-prod.fluidtopics.net/_xpXZ1MzROkQ0B2QnwIdBg "Currency values can be converted to other currencies when stored and accessed.") * Develop: [GlideCurrencyConverter](https://developer.servicenow.com/go_to_api.do?ID=GlideCurrencyConverterScopedAPI&v=kingston) [GlideCurrencyExchangeValue](https://developer.servicenow.com/go_to_api.do?ID=GlideCurrencyExchangeValueScopedAPI&v=kingston) {#fx-currency-configure__ul_tjc_xpz_xjb} | | glide.currency2.default_reference_currency | reference_currency | Three-digit ISO currency code used for the reference currency. The default reference currency for FX Currency fields is the system reference currency. * Type: String * Default value: If you set glide.system.reference_currency to true, the three-digit ISO currency code determined by glide.system.reference_currency.code. If set to false, the system locale is the default. * Learn more: [Session and reference currency](https://servicenow-prod.fluidtopics.net/gjPvC6eeJ5AplVgeaEbVZw "The default, or standard, currency fields in the ServiceNow AI Platform use two kinds of currency, Session and Reference.") * Develop: [GlideElementCurrency2](https://developer.servicenow.com/go_to_api.do?ID=GlideElementCurrency2API&v=kingston) {#fx-currency-configure__ul_alc_xpz_xjb} | [Table 1. FX Currency field properties and attributes] {#fx-currency-configure__table_j32_npz_xjb} **Related concepts** * [Configuring FX Currency field behavior](https://servicenow-prod.fluidtopics.net/qK7lN0TKzVNY9eYTRS1nHA "After establishing global currency defaults, you can create custom FX Currency configurations for specific table fields. Identify the table fields that use FX Currency, and define how currency conversion calculations should be performed, displayed, filtered, and aggregated.") **Related tasks** * [Add conversion rates using a custom rate table](https://servicenow-prod.fluidtopics.net/B8cYf45ov0FsuiCXko5ddg "You can create a custom rate table to ensure repeatable and consistent calculations. In a custom rate table, you control the conversion rates and the frequency of rate conversions. If you don't define custom rate tables, FX Currency fields use the System Conversion Currency Rate [fx_system_rate] table, which updates rates daily from the ECB (European Central Bank) website.") * [Add an FX Currency field to a table](https://servicenow-prod.fluidtopics.net/xlINoQCU8EUk~mjnZGJaFA "Before using and configuring an FX Currency field, you first add it an existing table, or to a new one, in System Definition > Tables.") * [Updating the Currency Instance record](https://servicenow-prod.fluidtopics.net/7jzPHScA1FbcMJPdtRTr1Q "If you have an assigned role of currency_instance_admin, you can review and edit the details of a currency entry in an FX Currency field. You can't edit the reference currency and value because they are calculated automatically.") *[\>]: and then