currency settings

📅 November 21, 2026 👁️ 0

currency settings

Currency settings are used to define the currency name, international code, and symbol displayed in the mall and in the order interface return.

Entry Path

Top menu of the back-end →「Settings」→「Currency Settings」. Actual address:/system/setting/currencyrequires administrative privileges(canAdmin)

Function description

The page contains only one settings form, including currency name, international code, and currency symbol, which takes effect on the mall front-end and interface return after saving.

Screenshot of the interface

currency settings

Setting item description

Setting items function Value / Default How to select / Fill in suggestions Impact / Note
Currency Name Currency name displayed on the back-end and front-end Text, the default value is not noted in the source code [Source code] Fill in「RMB」for domestic malls and「USD」for foreign trade Used for back-end order and financial display
Currency international code Standard three-letter code AsCNY/USD/EUR[Source code] Follow ISO 4217 and fill in according to the settlement currency Returned to the user side by the interface, the front-end judges the currency based on this.
Currency Symbol Symbol displayed before price As¥/$/€[Source code] Corresponding to currency, Renminbi¥, US Dollar$ Only changes the display, will not convert the existing price

Detailed explanation of configuration items

Attention to filling in the currency symbol field

Condition for occurrence: Always display [实测].

In the source codeCurrencyConfigDefinedName/Currency/SymbolThree fields (config/setting.go:136-140), but the two input boxes of 'currency international code' and 'currency symbol' on the front-end page use the same submission field name, which may cause the symbol value to overwrite the code value [COMPUTED].

Suggestion: After filling in, check the actual output on the front-end product page and order interface; if the code is displayed as a symbol, adjust the order of filling or check the patch version.

Consequences of filling in incorrectly: International shopping mall may occur currency identification error.

Operation steps

  1. Enter 'Settings → Currency Settings'.
  2. Fill in the currency name, international code, and symbol.
  3. Click 'Submit' to save.
  4. Confirm the correct display in the product details page and order interface.

Applicable scenarios and suggestions

  • Domestic mall: Renminbi /CNY/¥.
  • Foreign trade mall: Fill in the corresponding code and symbol according to the target market, and ensure that the template price formatting logic is in coordination.

Front-end call example

The order-related interface will return the currency symbol fieldcurrency_symbol, the front-end display should be based on the back-end returned value, avoid hardcoding:

{% archiveSku productSku with id=1 %}
{{ productSku.Price }}
{% endarchiveSku %}

priceFormatThe source of the symbol of the label is the configuration on this page.

Points to note

  • The currency setting only changes the display symbol and will not automatically convert the existing price. Adjust the product price before switching the currency.
  • Note that there is a field name conflict in the submission field of the above currency symbol field, be sure to check on the front end after saving.
  • The mall mode needs to be enabled in「Global Settings → Operation and SEO Status」.

Related documents

Related articles

Content settings

Content settings are used to control the document editor, URL generation rules, list pagination, image processing and thumbnail strategy, affecting the way content is entered and displayed on the front end of the entire site.

2026-11-21

Contact information settings

Contact information settings are used to maintain contacts, phone numbers, addresses, email, WeChat, social media, and store information, provided for template calling and display on the front end.

2026-11-21

Home slide

The home slide is used to maintain the home Banner image and its links, ALT and description, managed by groups, and provided for template calling and display.

2026-11-21

AI Unified Configuration

AI Unified Configuration is used to centrally manage AI writing/translation interfaces, AI assistant interfaces, and the permissions and security strategies of the MCP open interfaces.

2026-11-21

Navigation settings

Navigation settings are used to maintain the navigation links on the website's front page, supporting custom navigation categories and a two-level navigation structure.

2026-11-21

Payment settings

Payment settings are used to maintain the收款账户receiving account for mall payment methods, configure channel credentials, limits, and health status.

2026-11-21

Content security settings

Content security settings are used to control background login captcha, access source restriction, API interface switch, as well as captcha, frequency, and sensitive word filtering for message comments.

2026-11-21

Sensitive word settings

Sensitive word settings are used to maintain a unified sensitive word library for the entire site. When the submitted content matches the word library, it will be intercepted or replaced.

2026-11-21