---
title: Smart Chinese analysis plugin
description: The Smart Chinese Analysis plugin integrates Lucene’s Smart Chinese analysis module into elasticsearch. It provides an analyzer for Chinese or mixed Chinese-English...
url: https://www.elastic.co/elastic/docs-builder/docs/4492/reference/elasticsearch/plugins/analysis-smartcn
products:
  - Elasticsearch
---

# Smart Chinese analysis plugin
The Smart Chinese Analysis plugin integrates Lucene’s Smart Chinese analysis module into elasticsearch.
It provides an analyzer for Chinese or mixed Chinese-English text. This analyzer uses probabilistic knowledge to find the optimal word segmentation for Simplified Chinese text. The text is first broken into sentences, then each sentence is segmented into words.

## Installation

This plugin can be installed using the [plugin manager](https://www.elastic.co/elastic/docs-builder/docs/4492/reference/elasticsearch/command-line-tools/elasticsearch-plugin):
```sh
sudo bin/elasticsearch-plugin install analysis-smartcn
```

The plugin must be installed on every node in the cluster, and each node must be restarted after installation.
You can also download this plugin for [offline install](/elastic/docs-builder/docs/4492/reference/elasticsearch/command-line-tools/elasticsearch-plugin#elasticsearch-plugin-ids). Download the build that matches the Elasticsearch version you are running.
<tab-set>
  <tab-item title="Latest">
    Download the build for 9.5.5:[[https://artifacts.elastic.co/downloads/elasticsearch-plugins/analysis-smartcn/analysis-smartcn-9.5.5.zip](https://artifacts.elastic.co/downloads/elasticsearch-plugins/analysis-smartcn/analysis-smartcn-9.5.5.zip)](https://artifacts.elastic.co/downloads/elasticsearch-plugins/analysis-smartcn/analysis-smartcn-9.5.5.zip)To verify the `.zip` file, use the [SHA hash](https://artifacts.elastic.co/downloads/elasticsearch-plugins/analysis-smartcn/analysis-smartcn-9.5.5.zip.sha512) or [ASC key](https://artifacts.elastic.co/downloads/elasticsearch-plugins/analysis-smartcn/analysis-smartcn-9.5.5.zip.asc).
  </tab-item>

  <tab-item title="Specific version">
    Replace `<SPECIFIC.VERSION.NUMBER>` with the Elasticsearch version you are running. For example, you can replace `<SPECIFIC.VERSION.NUMBER>` with `9.0.0`.
    - To download the build for the plugin, use this link:
      ```text
      https://artifacts.elastic.co/downloads/elasticsearch-plugins/analysis-smartcn/analysis-smartcn-<SPECIFIC.VERSION.NUMBER>.zip
      ```
    - To download the corresponding SHA hash to verify the `.zip` file, use this link:
      ```text
      https://artifacts.elastic.co/downloads/elasticsearch-plugins/analysis-smartcn/analysis-smartcn-<SPECIFIC.VERSION.NUMBER>.zip.sha512
      ```
    - To download the corresponding PGP signature (`.asc`) to verify the `.zip` file, use this link:
      ```text
      https://artifacts.elastic.co/downloads/elasticsearch-plugins/analysis-smartcn/analysis-smartcn-<SPECIFIC.VERSION.NUMBER>.zip.asc
      ```
  </tab-item>
</tab-set>

The plugin manager installs plugins on a self-managed cluster. To install this plugin on Elastic Cloud Hosted, Elastic Cloud Enterprise, or Elastic Cloud on Kubernetes, refer to the [plugin installation instructions for your deployment type](https://docs-v3-preview.elastic.dev/elastic/docs-builder/docs/4492/deploy-manage/plugins-and-custom-configuration-files#plugins-by-deployment-type).

## Removal

The plugin can be removed with the following command:
```sh
sudo bin/elasticsearch-plugin remove analysis-smartcn
```

The node must be stopped before removing the plugin.

## `smartcn` tokenizer and token filter

The plugin provides the `smartcn` analyzer, `smartcn_tokenizer` tokenizer, and `smartcn_stop` token filter which are not configurable.
<note>
  The `smartcn_word` token filter and `smartcn_sentence` have been deprecated.
</note>