How Telex and VNI work
Vietnamese uses the Latin alphabet with extra letters (ă â đ ê ô ơ ư) and five tone marks, so it is typed on a normal QWERTY keyboard with an input method that turns key combinations into marked letters. You type the base letter and then the key for its mark, either straight after it or at the end of the word.
| To get | Telex | VNI |
|---|---|---|
| ă | aw | a8 |
| â ê ô | aa ee oo | a6 e6 o6 |
| ơ ư | ow uw (or w alone for ư) | o7 u7 |
| ươ | uow | uo7 |
| đ | dd | d9 |
| sắc á | s | 1 |
| huyền à | f | 2 |
| hỏi ả | r | 3 |
| ngã ã | x | 4 |
| nặng ạ | j | 5 |
| Remove the tone | z | 0 |
Worked examples
| Word | Telex | VNI |
|---|---|---|
| Việt Nam | Vieejt Nam | Vie65t Nam |
| quốc | quoocs | quo6c1 |
| người | nguwowif or nguoiwf | nguoi72 |
| được | dduwowcj | d9uo7c5 |
| thuở | thuowr | thuo73 |
| cảm ơn | camr own | ca3m o7n |
Where the tone mark goes
The keyboard places tone marks by the standard spelling rules, in this order:
- If the syllable has a vowel with a hat, breve or horn, the tone goes on it: quốc, tiếng, người (on the ơ of ươ), thuở.
- Otherwise, if the syllable ends in a consonant, the tone goes on the last vowel: hoàng, toán, quýt.
- Otherwise, with three vowels it goes on the middle one: ngoài, khuỷu.
- With two vowels it goes on the first: mái, mùa, kìa, except that in oa, oe and uy the modern style puts it on the second (hoà, hoè, thuỳ) and the classic style on the first (hòa, hòe, thùy).
In gi and qu, the i and u belong to the consonant, so già and quá carry the tone on the a. When gi has no other vowel, the i takes it: gì.
How to add a Vietnamese keyboard to your device
Windows 10 and 11
- Open Settings, Time & language, Language & region, and choose Add a language. Pick Vietnamese and install it.
- Open the three dots next to Vietnamese, Language options, Add a keyboard, and choose Vietnamese Telex or Vietnamese Number Key-based (VNI). These are built in since Windows 10 version 1903; the older plain "Vietnamese" keyboard is not Telex.
- Switch with Win+Space. Many Vietnamese users install the free UniKey or EVKey instead, which add more options.
macOS
- Open System Settings, Keyboard, and next to Input Sources click Edit.
- Click +, choose Vietnamese, and select Telex, Simple Telex or VNI.
- Switch with Control+Space or the Globe key.
iPhone and iPad
- Open Settings, General, Keyboard, Keyboards, Add New Keyboard, and choose Vietnamese.
- Pick Telex, VNI or VIQR. Tap the globe key to switch keyboards.
Android (Gboard)
- Open Gboard's settings, then Languages, Add keyboard, and choose Vietnamese.
- Pick the layout you prefer from those offered, then Done. Touch and hold the space bar, or tap the globe key, to switch.