Cangjie input method
Coding of "倉頡輸入法" (i.e. Cangjie method) in traditional Chinese characters
Traditional Chinese倉頡輸入法
Simplified Chinese仓颉输入法

The Cangjie input method (Tsang-chieh input method, sometimes called Changjie, Cang Jie, Changjei[1] or Chongkit) is a system for entering Chinese characters into a computer using a standard computer keyboard. In filenames and elsewhere, the name Cangjie is sometimes abbreviated as cj.

The input method was invented in 1976 by Chu Bong-Foo, and named after Cangjie (Tsang-chieh), the mythological inventor of the Chinese writing system, at the suggestion of Chiang Wei-kuo, the former Defense Minister of Taiwan. Chu Bong-Foo released the patent for Cangjie in 1982, as he thought that the method should belong to Chinese cultural heritage.[2] Therefore, Cangjie has become open-source software and is on every computer system that supports traditional Chinese characters, and it has been extended so that Cangjie is compatible with the simplified Chinese character set.

A Chinese keyboard in Shek Tong Tsui Municipal Services Building, Hong Kong with Cangjie hints printed on the lower-left corners of the keys. (Printed on the lower-right and upper-right corners are Dayi hints and Zhuyin symbols respectively.)

Cangjie is the first Chinese input method to use the QWERTY keyboard. Chu saw that the QWERTY keyboard had become an international standard, and therefore believed that Chinese-language input had to be based on it.[3] Other, earlier methods use large keyboards with 40 to 2400 keys, except the Four-Corner Method, which uses only number keys.

Unlike the Pinyin input method, Cangjie is based on the graphological aspect of the characters: each graphical unit, called a "radical" (not to be confused with Kangxi radicals), is re-parented by a basic character component, 24 in total, each mapped to a particular letter key on a standard QWERTY keyboard. An additional "difficult character" function is mapped to the X key. Keys are categorized into four groups, to facilitate learning and memorization. Assigning codes to Chinese characters is done by separating the constituent "radicals" of the characters.


Keys and "radicals"

The basic character components in Cangjie are called "radicals" (字根) or "letters" (字母). There are 24 radicals but 26 keys; the 24 radicals (the basic shapes 基本字形) are associated with roughly 76 auxiliary shapes (輔助字形), which in many cases are either rotated or transposed versions of components of the basic shapes. For instance, the letter A () can represent either itself, the slightly wider , or a 90° rotation of itself. (For a more complete account of the 76-odd transpositions and rotations than the ones listed below, see the article on Cangjie entry in Chinese Wikibooks.)

The 24 keys are placed in four groups:

Group Key Name Primary meaning
Philosophical group A sun , , 90° rotated (as in )
B moon the top four strokes of ; ; ; ; the top and top-left part of , , and ; the top-left four strokes of and ; and the top four strokes of
C gold itself, , , and the penultimate two strokes of and
D wood itself, the first two strokes of and , the first two strokes of and
E water , the last five strokes of and ,
F fire the shape , , the first three strokes in and
G earth itself, or for soldier
Stroke group H bamboo

( apostrophe)

The slant and short slant, the Kangxi radical , namely the upper parts in and
I dagger axe ( dot) The dot, the first three strokes in and , and the shape
J ten ( cruciform) The cross shape and the shape
K big ( cross) The X shape, including and the first two strokes of , as well as
L centre ( vertical) The vertical stroke, as well as and the first four strokes of and
M one ( horizontal) The horizontal stroke, as well as the final stroke of and , the shape , and the shape
N bow ( hook) The crossbow and the hook
Body parts group O person The dismemberment; the Kangxi radical ; the first two strokes of and ; the first two strokes of , , and ; and the final two strokes of
P heart The Kangxi radical ; the second stroke in ; the last four strokes in , , and ; the shape ; the shape ; the penultimate two strokes in ; and the shape
Q hand The Kangxi radical
R mouth The Kangxi radical
Character shapes group S corpse , the first two strokes of , the first stroke of and , the third stroke of and , the first four strokes of and
T 廿 twenty Two vertical strokes connected by a horizontal stroke; the Kangxi radical when written as (whether the horizontal stroke is connected or broken)
U mountain Three-sided enclosure with an opening on the top
V woman A hook to the right; a V shape; the last three strokes in , , and
W field Itself, as well as any four-sided enclosure with something inside it, including the first two strokes in and
Y fortune telling The shape and rotated forms, the shape , the first two strokes in
Collision/Difficult key* X / collision/difficult (1) disambiguation of Cangjie code decomposition collisions, (2) code for a "difficult-to-decompose" part
Special character key* Z (See note) Auxiliary code used for entering special characters (no meaning on its own). In most cases, this key combined with other keys will produce Chinese punctuations (such as 。,、,「 」,『 』).

Note: Some variants use Z as a collision key instead of X. In those systems, Z has the name "collision" () and X has the name "difficult" (); but the use of Z as a collision key is neither in the original Cangjie nor used in the current mainstream implementations. In other variants, Z may have the name "user-defined" () or some other name.

Wildcard Shift + 8 (*) Wildcard It can replace any key from 2nd to 5th place, and return a list that matches the combination. It is very useful for unknown guesses when you are sure about the first and last input. (e.g. Input * will include the following in the list: , , , )

The auxiliary shapes of each Cangjie radical have changed slightly across different versions of the Cangjie method. Thus, this is one reason that different versions of the Cangjie method are not completely compatible.

Chu Bong-Foo has provided alternate names for some letters according to their characteristics. For example, H () is also called , which means slant. The names form a rhyme to help learners memorize the letters, each group being in a line (The sounds of final characters are given in parentheses):

; gōu
; kǒu

Keyboard layout

A typical keyboard layout for Cangjie method, based on United States keyboard layout. Note the non-standard use of Z as the collision key.

Basic rules

The typist must be familiar with several decomposition rules (拆字規則) that define how to analyze a character to arrive at a Cangjie code.

The rules are subject to various principles:


Typing Chinese with Cangjie input method version 5
Typing Chinese with Cangjie input method on an Android device


Some forms are always decomposed in the same way, whether the rules say they should be decomposed this way or not. The number of such exceptions is small:

Form Fixed decomposition
Version 2 Version 3 Version 5
(door) (AN)
(eye) (BU)
(ghost) (HI) (HI) or HUI
(small table) (HU) (HN)
(win) (YRBBN) (YNBUC)
(tiger [radical]) (YP)
on top of () (YR) (YVR)
(fowl) (OG)
(air [radical]) (OU) (ON) (OMN)
minus the (VI)
(compete) (LN)
(mound or city radical) (NL)

Some forms cannot be decomposed. They are represented by an X, which is the key on a Cangjie keyboard.[4]

Form Fixed decomposition (v5)

Early development

Initially, the Cangjie input method was not intended to produce a character in any character set. Instead, it was part of an integrated system consisting of the Cangjie input rules and a Cangjie controller board. This controller board contains character generator firmware, which dynamically generates Chinese characters from Cangjie codes when characters are output, using the hi-res graphics mode of the Apple II computer. In the preface of the Cangjie user's manual, Chu Bong-Foo wrote in 1982:

[in translation]
In terms of output: The output and input, in fact, [form] an integrated whole; there is no reason that [they should be] dogmatically separated into two different facilities.… This is in fact necessary.…

In this early system, when the user types "yk", for example, to get the Chinese character , the Cangjie codes do not get converted to any character encoding and the actual string "yk" is stored. The Cangjie code for each character (a string of 1 to 5 lowercase letters plus a space) was the encoding of that particular character.

Demonstration of character generator Mingzhu's capability to generate characters according to the codes. The first character is 𮨻 (⿰飠它), which denotes a kind of soup in Xuzhou cuisine.

A particular "feature" of this early system is that, if one sends random lowercase words to it, the character generator will attempt to construct Chinese characters according to the Cangjie decomposition rules, sometimes causing strange, unknown characters to appear. This unintended feature, "automatic generation of characters", is described in the manual and is responsible for producing more than 10,000 of the 15,000 characters that the system can handle. The name Cangjie, evocative of the creation of new characters, was indeed apt for this early version of Cangjie.

The presence of the integrated character generator also explains the historical necessity for the existence of the "X" key, which is used for the disambiguation of decomposition collisions: because characters are "chosen" when the codes are "output", every character that can be displayed must in fact have a unique Cangjie decomposition. It would not make sense—nor would it be practical—for the system to provide a choice of candidate characters when a random text file is displayed, as the user would not know which of the candidates is correct.


Cangjie was designed to be an easy-to-use system to help promote the use of Chinese computing. However, many users find Cangjie is difficult to learn and use, with many difficulties caused by poor instruction.[citation needed]

Perceived difficulties

With enough practice, users can overcome the above problems. Typical touch-typists can type Chinese at 25 characters per minute (cpm), or better, using Cangjie, despite having difficulty remembering the list of auxiliary shapes or the decomposition rules. Experienced Cangjie typists can reportedly attain a typing speed from 60 cpm to over 200 cpm.

according to Chen Minzheng, his teaching experience at Longtian Elementary School in Taitung in 1990, the average typing speed of children was 90 words per minute, and some children even reached more than 130 words per minute.[5]

Limitations in implementation

The decomposition of a character depends on a predefined set of "standard shapes" (標準字形). However, as many variations of Cangjie exist in different countries, the standard shape of a certain character in Cangjie is not always the one the user has learnt before. Learning Cangjie then entails learning not only Cangjie itself but also unfamiliar standard shapes for some characters. The Cangjie input method editor (IME) does not handle mistakes in decomposition except by informing the user (usually by beeping) that there is a mistake. However, Cangjie is originally designed to assign different codes to different variants of a character. For example, in the Cangjie provided on Windows, the code for is YHHQM, which corresponds not to the shape of this character but to another variant, . This is a problem resulting from the implementation of Cangjie on Windows. In the original Cangjie, should be YKMHM (the first part is ) while is YHHQM (the first part is ).

Punctuation marks are not geometrically decomposed, but rather given predefined codes that begin with ZX followed by a string of three letters related to the ordering of the characters in the Big5 code. (This set of codes was added to Cangjie on the traditional Chinese version of Windows 95. On Windows 3.1, Cangjie did not have a set of codes for punctuation marks.) Typing punctuation marks in Cangjie thus becomes a frustrating exercise involving either memorization or pick-and-peck. However, this is solved on modern systems through accessing a virtual keyboard on screen (On Windows, this is activated by pressing Ctrl + Alt + comma key).

Commonly-made errors include not considered as alternative codes. For example, if one does not decompose from top to bottom into YHS, but instead type YSH according to stroke order, Cangjie does not return the character as a choice.

Since Cangjie requires all 26 keys of the QWERTY keyboard, it cannot be used to input Chinese characters on feature phones, which have only a 12-key keypad. Alternative input methods, such as Zhuyin, 5-stroke (or 9-stroke by Motorola), and the Q9 input method, are used instead.


The Cangjie input method is commonly said to have gone through five generations (commonly referred to as "versions" in English), each of which is slightly incompatible with the others. Currently, version 3 (第三代倉頡) is the most common and supported natively by Microsoft Windows. Version 5 (第五代倉頡), supported by the Free Cangjie IME and previously the only Cangjie supported by SCIM, represents a significant minority method and is supported by iOS.

The early Cangjie system supported by the Zero One card on the Apple II was Version 2; Version 1 was never released.

The Cangjie input method supported on the classic Mac OS resembles both Version 3 and Version 5.

Version 5, like the original Cangjie input method, was created directly by Chu. He had hoped that the release of Version 5, originally slated to be Version 6, would bring an end to the "more than ten versions of Cangjie input method" (slightly incompatible versions created by different vendors).

Version 6 has not yet been released to the public, but is being used to create a database which can accurately store every historical Chinese text.


Most modern implementations of Cangjie input method editors (IME) provide various convenient features:

Besides the wildcard key, many of these features are convenient for casual users but unsuitable for touch-typists because they make the Cangjie IME unpredictable.

There have also been various attempts to "simplify" Cangjie one way or another:


Many researchers have discussed ways to decompose Chinese characters into their major components, and tried to build applications based on the decomposition system. The idea can be referred to as the study of the Genes of Chinese Characters [zh]. Cangjie codes offer a basis for such an endeavour. Academia Sinica in Taiwan[6] and Jiaotong University in Shanghai[7] have similar projects as well.

One direct application of the use of decomposed characters is the possibility of computing the similarities between different Chinese characters.[8] The Cangjie input method offers a good starting point for this kind of application. By relaxing the limit of five codes for each Chinese character and adopting more detailed Cangjie codes, visually similar characters can be found by computation. Integrating this with pronunciation information enables computer-assisted learning of Chinese characters.[9]

See also


This article may require cleanup to meet Wikipedia's quality standards. The specific problem is: these footnotes should be linked to the places in the text above they refer to, e.g. with Template:efn. Please help improve this article if you can. (May 2022) (Learn how and when to remove this template message)


  1. ^ A spelling used as filename on ETen Chinese System.
  2. ^ Chu, Chyi-Hwa (朱麒華) (1 February 2012). "教育科技的專利與普及". National Academy for Educational Research e-Newsletter (in Chinese). Archived from the original on 25 August 2022. Retrieved 14 December 2022.
  3. ^ Chu Bong-foo (朱邦復). "智慧之旅". 開放文學 (in Traditional Chinese). Archived from the original on 19 October 2017. Retrieved 8 June 2017.
  4. ^ "倉頡取碼規則及方法" [Cangjie code retrieval rules and methods]. Friends of Cangjie (in Chinese). 1997–2002. Archived from the original on 1 January 2019. Retrieved 2 October 2020.
  5. ^ page 58
  6. ^ "漢字構形資料庫" [Chinese Character Configuration Database]. Chinese Document Processing Lab (in Chinese). 2013. Archived from the original on 27 July 2020. Retrieved 2 October 2020.
  7. ^ 上海交通大學漢字編碼組,上海漢語拼音文字研究組編著。漢字信息字典。北京市科學出版社,1988。
  8. ^ 宋柔,林民,葛詩利。漢字字形計算及其在校對系統中的應用,小型微型計算機系統,第29卷第10期,第1964至1968頁,2008。
  9. ^ Liu, Chao-Lin; Lai, Min-Hua; Tien, Kan-Wen; Chuang, Yi-Hsuan; Wu, Shih-Hung; Lee, Chia-Ying (2011). "Visually and phonologically similar characters in incorrect Chinese words: Analyses, identification, and applications". ACM Transactions on Asian Language Information Processing. 10 (2): 1–39. doi:10.1145/1967293.1967297. S2CID 7288710.