Skip to content

Localization: big docs update (#8961)#9021

Open
vladaskorohodova wants to merge 1 commit into
DevExpress:mainfrom
vladaskorohodova:localization26_2
Open

Localization: big docs update (#8961)#9021
vladaskorohodova wants to merge 1 commit into
DevExpress:mainfrom
vladaskorohodova:localization26_2

Conversation

@vladaskorohodova

Copy link
Copy Markdown
Collaborator

No description provided.

# Conflicts:
#	concepts/Common/Localization/01 Dictionaries/02 Create a New Dictionary.md
#	concepts/Common/Localization/01 Dictionaries/07 Override Strings in a Dictionary.md
#	concepts/Common/Localization/01 Dictionaries/Dictionaries.md
#	concepts/Common/Localization/05 Localize Dates, Numbers, and Currencies/05 Using Intl.md
#	concepts/Common/Localization/05 Localize Dates, Numbers, and Currencies/10 Using Globalize.md
#	concepts/Common/Localization/20 Right-to-Left Support.md
@vladaskorohodova vladaskorohodova self-assigned this Jul 17, 2026
Copilot AI review requested due to automatic review settings July 17, 2026 10:28

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR reorganizes DevExtreme documentation around a new “Localization and Globalization” area, migrating/removing legacy Localization and Value Formatting topics and updating references across Guides and API Reference pages to point to the new structure.

Changes:

  • Replaces legacy Common/Localization and Common/Value Formatting topic trees with a new Common/Localization and Globalization structure (Overview, UI Text Localization, Value Formatting, RTL).
  • Updates many Guide/API Reference cross-links to the new topic locations and refreshes several embedded framework samples.
  • Removes component-specific localization documentation for List and adjusts some callers (but a few references still point to the removed file).

Reviewed changes

Copilot reviewed 128 out of 129 changed files in this pull request and generated 15 comments.

Show a summary per file
File Description
MenuConfig.xml Updates menu routing for the Localization/Globalization content area.
concepts/Common/Value Formatting/Value Formatting.md Removes legacy Value Formatting landing page.
concepts/Common/Value Formatting/40 Format Custom Values.md Removes legacy “Format Custom Values” article.
concepts/Common/Value Formatting/10 Format UI Component Values/30 Custom Function.md Removes legacy formatting custom function article.
concepts/Common/Value Formatting/10 Format UI Component Values/15 Intl Formats.md Removes legacy Intl formats article.
concepts/Common/Value Formatting/10 Format UI Component Values/10 Predefined Formats.md Removes legacy predefined formats article.
concepts/Common/Localization/Localization.md Removes legacy Localization overview.
concepts/Common/Localization/15 Localize Custom Values.md Removes legacy “Localize Custom Values” article.
concepts/Common/Localization/05 Localize Dates, Numbers, and Currencies/Localize Dates, Numbers, and Currencies.md Removes legacy value localization intro article.
concepts/Common/Localization/05 Localize Dates, Numbers, and Currencies/10 Using Globalize.md Removes legacy Globalize usage article.
concepts/Common/Localization/05 Localize Dates, Numbers, and Currencies/05 Using Intl.md Removes legacy Intl usage article.
concepts/Common/Localization/01 Dictionaries/Dictionaries.md Removes legacy dictionaries overview.
concepts/Common/Localization/01 Dictionaries/07 Override Strings in a Dictionary.md Removes legacy override strings article.
concepts/Common/Localization/01 Dictionaries/05 Add Strings to a Dictionary.md Removes legacy add strings article.
concepts/Common/Localization/01 Dictionaries/02 Create a New Dictionary.md Removes legacy create dictionary article.
concepts/Common/Localization and Globalization/20 Right-to-Left (RTL) Support.md Updates/modernizes RTL guidance and samples.
concepts/Common/Localization and Globalization/10 Value Formatting/40 Format and Parse Dates and Numbers.md Adds new combined format/parse article and samples.
concepts/Common/Localization and Globalization/10 Value Formatting/10 Format UI Component Values/30 Custom Function.md Adds new custom function formatting article and samples.
concepts/Common/Localization and Globalization/10 Value Formatting/10 Format UI Component Values/20 Custom Format String.md Updates LDML custom format string reference and notes.
concepts/Common/Localization and Globalization/10 Value Formatting/10 Format UI Component Values/15 Intl Formats.md Adds new Intl formats article and samples.
concepts/Common/Localization and Globalization/10 Value Formatting/10 Format UI Component Values/10 Predefined Formats.md Adds new predefined formats article and samples.
concepts/Common/Localization and Globalization/10 Value Formatting/10 Format UI Component Values/00 Format UI Component Values.md Adds/hosts the new “Format UI Component Values” section entry point.
concepts/Common/Localization and Globalization/10 Value Formatting/08 Using Globalize.md Adds new Globalize usage article with warnings.
concepts/Common/Localization and Globalization/10 Value Formatting/04 Using Intl.md Adds new Intl usage article and samples.
concepts/Common/Localization and Globalization/10 Value Formatting/00 Value Formatting.md Adds new Value Formatting landing page.
concepts/Common/Localization and Globalization/05 UI Text Localization/20 Override Strings in a Dictionary.md Adds new override strings article.
concepts/Common/Localization and Globalization/05 UI Text Localization/15 Add Strings to a Dictionary.md Adds new add strings article and samples.
concepts/Common/Localization and Globalization/05 UI Text Localization/10 Create a New Dictionary.md Adds new create dictionary article (BCP 47 guidance + note).
concepts/Common/Localization and Globalization/05 UI Text Localization/05 DevExtreme Dictionaries Reference.md Adds new dictionaries reference table and delivery notes.
concepts/Common/Localization and Globalization/05 UI Text Localization/00 UI Text Localization.md Adds new UI text localization landing page and samples.
concepts/Common/Localization and Globalization/00 Overview.md Adds new overall section overview and demo links.
concepts/80 Troubleshooting/10 Date String Handling Issues/05 Supported Formats, Exceptions, and Settings.md Retargets Value Formatting link to new location.
concepts/55 Vue Components/05 Add DevExtreme to a Vue Application/63 Register 3rd-Party Dependencies/2 Globalize Registration.md Retargets Globalize/Intl references to new docs.
concepts/50 React Components/05 Add DevExtreme to a React Application/65 Additional Configuration for Webpack.md Retargets Globalize reference to new docs.
concepts/40 Angular Components/10 Getting Started/03 Add DevExtreme to an Angular CLI Application/08 Register 3rd-Party Dependencies/02 Globalize Registration.md Retargets Globalize/Intl references to new docs.
concepts/05 UI Components/PolarChart/10 Visual Elements/070 Axis Labels.md Updates Value Formatting link to new location and refines wording.
concepts/05 UI Components/PolarChart/10 Visual Elements/040 Tooltips.md Updates Value Formatting link to new location and refines wording.
concepts/05 UI Components/PolarChart/10 Visual Elements/030 Series Point Labels.md Updates Value Formatting link to new location and refines wording.
concepts/05 UI Components/List/50 Localization.md Removes List-specific localization article.
concepts/05 UI Components/List/45 End-User Interaction/01 Touch-Screen Gestures.md Updates “See Also” references (but still points to removed List localization page).
concepts/05 UI Components/List/35 Item Deletion/01 User Interaction.md Updates “See Also” references (but still points to removed List localization page).
concepts/05 UI Components/List/25 Selection/01 User Interaction.md Updates “See Also” references (but still points to removed List localization page).
concepts/05 UI Components/List/08 Paging.md Updates “See Also” references (but still points to removed List localization page).
concepts/05 UI Components/LinearGauge/10 Visual Elements/70 Tooltips.md Updates Value Formatting link to new location and refines wording.
concepts/05 UI Components/DateRangeBox/10 Value Formatting and Masked Input.md Retargets predefined/custom formats links to new docs.
concepts/05 UI Components/DateBox/04 Value Formatting and Masked Input.md Retargets predefined/custom formats links and refines wording.
concepts/05 UI Components/DateBox/01 Overview/10 Key Features.md Retargets formatting links to new docs and minor copy edits.
concepts/05 UI Components/CircularGauge/10 Visual Elements/70 Tooltips.md Updates Value Formatting link to new location.
concepts/05 UI Components/Chat/40 Customize the Empty View.md Updates localization reference (currently still uses old route/title formatting).
concepts/05 UI Components/BarGauge/10 Visual Elements/40 Tooltips.md Updates Value Formatting link to new location and refines wording.
api-reference/50 Common/utils/localization/parseDate(text_format).md Updates text/links; reference target currently mismatches link label.
api-reference/50 Common/utils/localization/localization.md Updates shortDescription and See Also links to new docs.
api-reference/50 Common/utils/localization/locale(locale).md Updates See Also link to new overview.
api-reference/50 Common/utils/localization/locale().md Updates See Also link text/target to new overview.
api-reference/50 Common/utils/localization/loadMessages(messages).md Retargets example link to new UI text localization article.
api-reference/50 Common/utils/localization/formatNumber(value_format).md Updates param text and See Also link (target currently mismatches label).
api-reference/50 Common/utils/localization/formatMessage(key_value).md Retargets example link to new UI text localization article.
api-reference/50 Common/utils/localization/formatDate(value_format).md Updates param text and See Also link (target currently mismatches label).
api-reference/50 Common/Object Structures/GlobalConfig/timeFormat.md Retargets custom format string/function links to new docs.
api-reference/50 Common/Object Structures/GlobalConfig/thousandsSeparator.md Retargets localization/value formatting reference to new docs.
api-reference/50 Common/Object Structures/GlobalConfig/numberFormat.md Retargets custom format string/function links to new docs.
api-reference/50 Common/Object Structures/GlobalConfig/defaultCurrency.md Retargets Localization link to new overview.
api-reference/50 Common/Object Structures/GlobalConfig/decimalSeparator.md Retargets localization/value formatting reference to new docs.
api-reference/50 Common/Object Structures/GlobalConfig/dateTimeFormatPresets.md Retargets custom format string/function links to new docs.
api-reference/50 Common/Object Structures/GlobalConfig/dateTimeFormat.md Retargets custom format string/function links to new docs.
api-reference/50 Common/Object Structures/GlobalConfig/dateFormat.md Retargets custom format string/function links to new docs.
api-reference/50 Common/Object Structures/format/type.md Retargets Value Formatting link and related references to new docs.
api-reference/50 Common/Object Structures/format/format.md Retargets Globalize and custom format string references to new docs.
api-reference/50 Common/Object Structures/format/currency.md Retargets Localization link to new overview.
api-reference/40 Common Types/BaseWidgetTooltip/format.md Retargets Value Formatting link to new docs.
api-reference/40 Common Types/05 charts/BaseChartTooltip/argumentFormat.md Retargets Value Formatting link to new docs.
api-reference/30 Data Layer/PivotGridDataSource/1 Configuration/fields/format.md Retargets custom format string link and copy edits.
api-reference/10 UI Components/dxRangeSelector/1 Configuration/sliderMarker/format.md Retargets Value Formatting link to new docs.
api-reference/10 UI Components/dxRangeSelector/1 Configuration/scale/label/customizeText.md Retargets Value Formatting link to new docs.
api-reference/10 UI Components/dxPolarChart/5 Series Types/CommonPolarChartSeries/label/customizeText.md Retargets Value Formatting link to new docs.
api-reference/10 UI Components/dxPolarChart/5 Series Types/CommonPolarChartSeries/label/argumentFormat.md Retargets Value Formatting link to new docs.
api-reference/10 UI Components/dxPolarChart/1 Configuration/valueAxis/label/customizeText.md Retargets Value Formatting link to new docs.
api-reference/10 UI Components/dxPolarChart/1 Configuration/argumentAxis/label/customizeText.md Retargets Value Formatting link to new docs.
api-reference/10 UI Components/dxPieChart/5 Series Types/CommonPieChartSeries/label/customizeText.md Retargets Value Formatting link to new docs.
api-reference/10 UI Components/dxPieChart/5 Series Types/CommonPieChartSeries/label/argumentFormat.md Retargets Value Formatting link to new docs.
api-reference/10 UI Components/dxNumberBox/1 Configuration/format.md Retargets “Custom Function” doc link to new location.
api-reference/10 UI Components/dxList/1 Configuration/refreshingText.md Updates “See Also” but still points to removed List localization page.
api-reference/10 UI Components/dxList/1 Configuration/pullingDownText.md Updates “See Also” but still points to removed List localization page.
api-reference/10 UI Components/dxList/1 Configuration/pulledDownText.md Updates “See Also” but still points to removed List localization page.
api-reference/10 UI Components/dxList/1 Configuration/pageLoadingText.md Updates shortDescription and “See Also” (link still points to removed page).
api-reference/10 UI Components/dxList/1 Configuration/nextButtonText.md Updates “See Also” but still points to removed List localization page.
api-reference/10 UI Components/dxFunnel/1 Configuration/label/format.md Copy edit + retargets Value Formatting link.
api-reference/10 UI Components/dxDateBox/1 Configuration/pickerType.md Copy edit + retargets localization reference.
api-reference/10 UI Components/dxDateBox/1 Configuration/displayFormat.md Retargets “Format Widget Values” link to new formatting entry.
api-reference/10 UI Components/dxChart/9 Types/ArgumentAxisLabel/format.md Retargets Value Formatting link to new docs.
api-reference/10 UI Components/dxChart/5 Series Types/StockSeries/label/customizeText.md Copy edit + retargets Value Formatting link.
api-reference/10 UI Components/dxChart/5 Series Types/StepLineSeries/label/customizeText.md Copy edit + retargets Value Formatting link.
api-reference/10 UI Components/dxChart/5 Series Types/StepAreaSeries/label/customizeText.md Copy edit + retargets Value Formatting link.
api-reference/10 UI Components/dxChart/5 Series Types/StackedSplineSeries/label/customizeText.md Copy edit + retargets Value Formatting link.
api-reference/10 UI Components/dxChart/5 Series Types/StackedSplineAreaSeries/label/customizeText.md Copy edit + retargets Value Formatting link.
api-reference/10 UI Components/dxChart/5 Series Types/StackedLineSeries/label/customizeText.md Copy edit + retargets Value Formatting link.
api-reference/10 UI Components/dxChart/5 Series Types/StackedBarSeries/label/customizeText.md Copy edit + retargets Value Formatting link.
api-reference/10 UI Components/dxChart/5 Series Types/StackedAreaSeries/label/customizeText.md Copy edit + retargets Value Formatting link.
api-reference/10 UI Components/dxChart/5 Series Types/SplineSeries/label/customizeText.md Copy edit + retargets Value Formatting link.
api-reference/10 UI Components/dxChart/5 Series Types/SplineAreaSeries/label/customizeText.md Copy edit + retargets Value Formatting link.
api-reference/10 UI Components/dxChart/5 Series Types/ScatterSeries/label/customizeText.md Retargets Value Formatting link.
api-reference/10 UI Components/dxChart/5 Series Types/RangeBarSeries/label/customizeText.md Copy edit + retargets Value Formatting link.
api-reference/10 UI Components/dxChart/5 Series Types/RangeAreaSeries/label/customizeText.md Copy edit + retargets Value Formatting link.
api-reference/10 UI Components/dxChart/5 Series Types/LineSeries/label/customizeText.md Copy edit + retargets Value Formatting link.
api-reference/10 UI Components/dxChart/5 Series Types/FullStackedSplineSeries/label/customizeText.md Copy edit + retargets Value Formatting link.
api-reference/10 UI Components/dxChart/5 Series Types/FullStackedSplineAreaSeries/label/customizeText.md Copy edit + retargets Value Formatting link.
api-reference/10 UI Components/dxChart/5 Series Types/FullStackedLineSeries/label/customizeText.md Copy edit + retargets Value Formatting link.
api-reference/10 UI Components/dxChart/5 Series Types/FullStackedBarSeries/label/customizeText.md Copy edit + retargets Value Formatting link.
api-reference/10 UI Components/dxChart/5 Series Types/FullStackedAreaSeries/label/customizeText.md Copy edit + retargets Value Formatting link.
api-reference/10 UI Components/dxChart/5 Series Types/CommonSeries/label/format.md Retargets Value Formatting link.
api-reference/10 UI Components/dxChart/5 Series Types/CommonSeries/label/customizeText.md Retargets Value Formatting link.
api-reference/10 UI Components/dxChart/5 Series Types/CommonSeries/label/argumentFormat.md Retargets Value Formatting link.
api-reference/10 UI Components/dxChart/5 Series Types/CandleStickSeries/label/customizeText.md Copy edit + retargets Value Formatting link.
api-reference/10 UI Components/dxChart/5 Series Types/BubbleSeries/label/customizeText.md Retargets Value Formatting link.
api-reference/10 UI Components/dxChart/5 Series Types/BarSeries/label/customizeText.md Retargets Value Formatting link.
api-reference/10 UI Components/dxChart/5 Series Types/AreaSeries/label/customizeText.md Copy edit + retargets Value Formatting link.
api-reference/10 UI Components/dxChart/1 Configuration/tooltip/contentTemplate.md Retargets Value Formatting link.
api-reference/10 UI Components/dxChart/1 Configuration/argumentAxis/label/format.md Copy edit + retargets Value Formatting link.
api-reference/10 UI Components/dxCalendar/1 Configuration/dateSerializationFormat.md Retargets custom format string link.
api-reference/10 UI Components/dxBarGauge/1 Configuration/label/format.md Retargets Value Formatting link.
api-reference/10 UI Components/DateBoxBase/1 Configuration/displayFormat.md Retargets “Format Widget Values” link.
api-reference/10 UI Components/DateBoxBase/1 Configuration/dateSerializationFormat.md Retargets custom format string link.
api-reference/10 UI Components/BaseWidget/1 Configuration/tooltip/format.md Retargets Value Formatting link.
api-reference/10 UI Components/BaseGauge/1 Configuration/tooltip/customizeTooltip.md Copy edit + retargets Value Formatting link.
api-reference/10 UI Components/BaseGauge/1 Configuration/scale/label/customizeText.md Retargets Value Formatting link.
api-reference/10 UI Components/BaseChart/1 Configuration/tooltip/contentTemplate.md Retargets Value Formatting link.
api-reference/10 UI Components/BaseChart/1 Configuration/tooltip/argumentFormat.md Retargets Value Formatting link.
api-reference/_hidden/dxFilterBuilderField/format.md Copy edit + retargets Value Formatting link.
api-reference/_hidden/dxDataGridColumn/format.md Copy edits + retargets formatting docs link (one target path is currently incorrect).
Comments suppressed due to low confidence (1)

concepts/Common/Localization and Globalization/10 Value Formatting/10 Format UI Component Values/20 Custom Format String.md:45

  • There is an extra space before the comma in "character ," and the sentence structure is awkward. This looks like a typo introduced in the rewrite.


- [Custom format string](/concepts/Common/Value%20Formatting/10%20Format%20Widget%20Values/20%20Custom%20Format%20String.md '/Documentation/Guide/Common/Value_Formatting/#Format_UI_Component_Values/Custom_Format_String')
Cannot be converted, the cell value is exported without formatting. To export this format, return the formatted string from the [customizeText](/api-reference/_hidden/GridBaseColumn/customizeText.md '/Documentation/ApiReference/UI_Components/dxDataGrid/Configuration/columns/#customizeText') callback as follows:
- [Custom format string](/concepts/Common/Localization%20and%20Globalization/10%20Value%20Formatting/10%20Format%20Widget%20Values/20%20Custom%20Format%20String.md '/concepts/Common/Localization%20and%20Globalization/10%20Value%20Formatting/10%20Format%20UI%20Component%20Values/20%20Custom%20Format%20String.md')
#####See Also#####
- **Data Binding**: [Web API and MongoDB](/concepts/70%20Data%20Binding/00%20Specify%20a%20Data%20Source/30%20Web%20API%20and%20MongoDB.md '/Documentation/Guide/Data_Binding/Specify_a_Data_Source/Web_API_and_MongoDB/') | [OData Service](/concepts/70%20Data%20Binding/00%20Specify%20a%20Data%20Source/40%20OData.md '/Documentation/Guide/Data_Binding/Specify_a_Data_Source/OData/') | [Custom Sources](/concepts/70%20Data%20Binding/00%20Specify%20a%20Data%20Source/60%20Custom%20Data%20Sources '/Documentation/Guide/Data_Binding/Specify_a_Data_Source/Custom_Data_Sources/') | [JavaScript Array](/concepts/70%20Data%20Binding/00%20Specify%20a%20Data%20Source/10%20Local%20Array.md '/Documentation/Guide/Data_Binding/Specify_a_Data_Source/Local_Array/')
- [List - Localization](/concepts/05%20UI%20Components/List/50%20Localization.md '/Documentation/Guide/UI_Components/List/Localization/')
- [List - Localization](/concepts/05%20UI%20Components/List/50%20Localization.md '/concepts/05%20UI%20Components/List/50%20Localization.md')
#####See Also#####
- [List - End-User Interaction | Universal Actions](/concepts/05%20UI%20Components/List/45%20End-User%20Interaction/05%20Universal%20Actions.md '/Documentation/Guide/UI_Components/List/End-User_Interaction/Universal_Actions/')
- [List - Localization](/concepts/05%20UI%20Components/List/50%20Localization.md '/Documentation/Guide/UI_Components/List/Localization/')
- [List - Localization](/concepts/05%20UI%20Components/List/50%20Localization.md '/concepts/05%20UI%20Components/List/50%20Localization.md')
#####See Also#####
- [List - Data Binding | Deletion in Custom Sources](/concepts/70%20Data%20Binding/00%20Specify%20a%20Data%20Source/60%20Custom%20Data%20Sources '/Documentation/Guide/Data_Binding/Specify_a_Data_Source/Custom_Data_Sources/')
- [List - Localization](/concepts/05%20UI%20Components/List/50%20Localization.md '/Documentation/Guide/UI_Components/List/Localization/')
- [List - Localization](/concepts/05%20UI%20Components/List/50%20Localization.md '/concepts/05%20UI%20Components/List/50%20Localization.md')
#####See Also#####
#include common-link-configurewidget
- [List - Localization](/concepts/05%20UI%20Components/List/50%20Localization.md '/Documentation/Guide/UI_Components/List/Localization/') No newline at end of file
- [List - Localization](/concepts/05%20UI%20Components/List/50%20Localization.md '/concepts/05%20UI%20Components/List/50%20Localization.md')
Comment on lines +130 to +132
Chat localizes these texts following your application locale. For more information about DevExtreme localization, refer to the following topic: [Localization](/concepts/Common/Localization '/concepts/Common/Localization%20and%20Globalization/00%20Overview.md').

### Customize Chat when Empty View is Displayed
### Customize the Chat when the Empty View is displayed

---
Refer to the following help topic for a code example: [Format Custom Values](/concepts/Common/Value%20Formatting/40%20Format%20Custom%20Values.md '/Documentation/Guide/Common/Value_Formatting/#Format_Custom_Values'). No newline at end of file
Refer to the following help topic for a code example: [Format Custom Values](/concepts/Common/Localization%20and%20Globalization/10%20Value%20Formatting/10%20Format%20UI%20Component%20Values/30%20Custom%20Function.md).

#####See Also#####
- [Format Custom Values](/concepts/Common/Value%20Formatting/40%20Format%20Custom%20Values.md '/Documentation/Guide/Common/Value_Formatting/#Format_Custom_Values') No newline at end of file
- [Format Custom Values](/concepts/Common/Localization%20and%20Globalization/10%20Value%20Formatting/10%20Format%20UI%20Component%20Values/30%20Custom%20Function.md)

#####See Also#####
- [Format Custom Values](/concepts/Common/Value%20Formatting/40%20Format%20Custom%20Values.md '/Documentation/Guide/Common/Value_Formatting/#Format_Custom_Values') No newline at end of file
- [Format Custom Values](/concepts/Common/Localization%20and%20Globalization/10%20Value%20Formatting/10%20Format%20UI%20Component%20Values/30%20Custom%20Function.md)
Comment on lines +118 to +134
const setParsedDate = useCallback((event) => {
setDate(parseDate(event.target.value, "shortDate"));
}, []);
const setParsedAmount = useCallback((event) => {
setAmount(parseNumber(event.target.value, "currency"));
}, []);

return (
<>
<input
defaultValue={getFormattedDate()}
onChange={setParsedDate}
/>
<input
defaultValue={getFormattedAmount()}
onChange={setParsedAmount}
/>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants