> For the complete documentation index, see [llms.txt](https://docs.akinon.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.akinon.com/quick-start/readme/4.-format-phone-numbers.md).
# 4. Format Phone Numbers
If your customers are located outside of Turkey, it's essential to configure phone number validation and formatting rules appropriately. By default, Akinon systems are configured to validate Turkish mobile numbers. To ensure accurate data collection for international numbers, you must adjust two dynamic settings.
{% stepper %}
{% step %}
### Define the Validation Rule with Regex \[`USER_PHONE_REGEX`]
The `USER_PHONE_REGEX` dynamic setting defines the validation rule for user phone numbers using a regular expression (regex).
**To configure this setting:**
* Go to **Omnitron > Sales Channels > Sales Channel Settings > Dynamic Settings**.
* Locate the `USER_PHONE_REGEX` setting.
By default, this setting is configured for Turkish phone numbers:
```regex
^(05)\d{9}$
```
**Breakdown of the default pattern:**
* `^` — Anchors the match to the beginning of the string
* `(05)` — The number must start with “05”
* `\d{9}` — Followed by exactly 9 digits
* `$` — Anchors the match to the end of the string
This pattern matches exactly 11-digit Turkish mobile numbers (e.g., 05xxxxxxxxx).
If your store serves users in other countries, you should **replace this pattern with a valid regex** for your desired format.
Need help with regex? [Here's a great resource](https://regex101.com/) for building patterns.
Once entered, **click Save** to apply the setting.
{% endstep %}
{% step %}
### Define the Display Format \[`USER_PHONE_FORMAT`]
The `USER_PHONE_FORMAT` dynamic setting controls the **human-readable** format for displaying user phone numbers.
**To configure this setting:**
* Stay in the **Dynamic Settings** section of the same Sales Channel.
* Locate the `USER_PHONE_FORMAT` setting.
* Enter the display format for phone numbers based on your country’s format (e.g., `+44XXXXXXXXXX` or `XXXXXXXXXX`).
* Click **Save** to apply the setting.
> ⚠️ The format you define in `USER_PHONE_FORMAT` **must be consistent** with the validation rule defined in `USER_PHONE_REGEX`.
>
> If they conflict, warning messages will be shown to users when inputting their phone numbers.
> {% endstep %}
> {% endstepper %}
---
# 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:
```
GET https://docs.akinon.com/quick-start/readme/4.-format-phone-numbers.md?ask=
```
The question should be specific, self-contained, and written in natural language.
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.