support for Elastic(Open)search CJK analysis plugins

[Combs7th]

Let's update the Mattermost Product Documentation to reflect the System Admin Elasticsearch/OpenSearch search configuration experience captured via Engineering PR mattermost/mattermost#34784

Scope & constraints

• Review PR #34784 as the source of truth before drafting.
• Use the milestone version from PR metadata: v11.6.0.
• Focus only on admin-visible capability and operational expectations proved by the PR:
• new ElasticsearchSettings.EnableCJKAnalyzers setting
• default is false
• supported analyzer plugins named in PR evidence: analysis-nori, analysis-kuromoji, analysis-smartcn
• applies to Elasticsearch and OpenSearch
• purpose is improved search behavior for Korean, Japanese, and Chinese when required plugins are installed
• Do not document implementation details, code structure, templates, internal test scaffolding, or Docker/local-dev setup unless an existing admin doc explicitly uses those pages for supported product setup.
• Do not modify: changelogs, important upgrade notes, version archive, removed/deprecated features, unsupported legacy releases.
• Any statement not directly supported by PR evidence must be marked: [NOT PRESENT IN PR — REQUIRES HUMAN JUDGMENT].
• Required doc touchpoints (pages/sections if known; otherwise "identify likely pages")
• Identify likely admin docs covering:
• Elasticsearch/OpenSearch configuration
• search configuration / search backend setup
• config.json / System Console reference for Elasticsearch settings
• Only touch end-user search docs if an existing page explicitly claims a CJK limitation that this PR resolves. Otherwise leave end-user docs unchanged. [NOT PRESENT IN PR — REQUIRES HUMAN JUDGMENT]
• For simple capability parity: Keep to ONE task, not multiple persona sections
• Keep this as one System Admin task.
• Output requirements (what to return: proposed text, page list, before/after, etc.)
• Return:
• whether a doc update is necessary
• the most likely existing page(s) to update
• a short rationale tied to PR evidence
• proposed doc text in the existing page style
• before/after snippets or exact insertion points
• The proposed update should, at minimum:
• name the new setting EnableCJKAnalyzers
• state that it is disabled by default
• state that required analyzer plugins must be installed
• name the supported plugins exactly as shown in the PR
• describe the admin-facing outcome as improved search results for Korean, Japanese, and Chinese
• Do not invent UI labels, System Console paths, or exact log messages unless explicitly present in PR evidence.

[Combs7th]

@claude - Please run the above analysis.

[claude]

Claude finished @Combs7th's task in 6m 3s —— View job • claude/issue-8829-20260324-2302 • Create PR ➔

---

Analysis: CJK Analysis Plugin Documentation Update

• Gather context (reading repo structure and doc files)
• Identify relevant documentation pages
• Implement doc updates (3 files modified)
• Commit and push changes

---

Decision: Doc update is necessary

Source of truth: ElasticsearchSettings.EnableCJKAnalyzers PR evidence as stated in the issue.

Pages updated

File	Change
administration-guide/configure/environment-configuration-settings.rst	New EnableCJKAnalyzers config setting entry added after the Trace setting
administration-guide/scale/elasticsearch-setup.rst	Optional CJK plugin installation note added after analysis-icu step
administration-guide/scale/opensearch-setup.rst	Optional CJK plugin installation note added after analysis-icu step

Pages left unchanged: enabling-chinese-japanese-korean-search.rst — already covers v11.5+ feature flag; no existing CJK limitation claim referencing Elasticsearch that this PR resolves.

---

What was added

environment-configuration-settings.rst — new setting entry in the Enterprise search section:

Enable CJK analyzers (ElasticsearchSettings.EnableCJKAnalyzers, env: MM_ELASTICSEARCHSETTINGS_ENABLECJKANALYZERS)

When enabled, Mattermost uses language-specific analyzer plugins to improve search results for Korean, Japanese, and Chinese content. The required analyzer plugins must be installed on the Elasticsearch or AWS OpenSearch server before enabling this setting.

Supported plugins: analysis-nori (Korean), analysis-kuromoji (Japanese), analysis-smartcn (Chinese)

Default: false. Available from Mattermost v11.6.

elasticsearch-setup.rst and opensearch-setup.rst — optional note added after the analysis-icu plugin step pointing admins to the CJK plugins and the EnableCJKAnalyzers setting.

---

|