KOI · Support

A little help, close at hand.

Add the keyboard, understand your choices, or find the next step when something does not work.

Updated: 5 October 2026

Getting started

Installing the app is not enough — iOS requires you to add the keyboard in Settings as well.

  1. Add the keyboard

    iOS Settings → General → Keyboard → Keyboards → Add New Keyboard… → choose KOI under “Third-Party Keyboards”.

  2. (Optional) Turn on Full Access

    On the same screen, select KOI and turn on “Allow Full Access”. It is needed for AI, clipboard paste, handwriting-model updates, and shared image-library archiving; without it the input method itself is completely normal.

  3. Switch to KOI

    In a text field, press and hold the globe key and choose KOI. To change the Chinese input mode, open the KOI app settings and choose Cangjie, Quick, Stroke, Jyutping or Zhuyin.

Enable AI when you need it

AI is optional. Ordinary input and on-device handwriting do not need AI consent or Credits.

  1. Choose your access

    In the KOI app, open “AI 與 Credits” → “啟用 KOI AI 代理”. Guest access does not require registration.

  2. Review and agree

    Read “AI 資料分享”, then agree if you want to use AI. Full Access alone does not grant AI consent. You can withdraw sharing consent from “AI 與 Credits”.

  3. Preview, then ask

    The keyboard needs Full Access, a working connection and enough Credits. Review the context and the result before using it.

Common questions

What is free, and what needs Plus?

Core Chinese input, candidates and on-device handwriting are available free. Plus adds prediction, appearance customization, key sizing and manual iCloud sync. InkGold and Recessed are Plus-exclusive.

AI uses Credits and separate consent. Buying Credits does not unlock Plus customization or sync. Current purchase details are shown in the app.

How do I restore a purchase?

Open “AI 與 Credits” → “恢復購買”, using the Apple Account that made the purchase. If access still looks wrong, contact support with the app version and the product purchased; do not send passwords or verification codes.

What can local correction learning remember?

With Personal Learning enabled, KOI can learn a supported correction when a local Chinese question is visible: delete its last character, replace it with a different Chinese character, then continue typing. It verifies the observed context and later input; it does not learn every edit.

Manage entries in 設定 → 輸入與候選 → 自動更正學習. Local learning does not need AI consent. A saved entry does not guarantee that every later suggestion will apply it.

Why does KOI need “Full Access”? Can I leave it off?

iOS gives a third-party keyboard no networking capability at all without this permission. KOI needs it to connect to the AI features, to read the clipboard (only at the moment you press Paste), to update the handwriting model, and to archive generated images in the app's shared image library.

Leaving it off is completely fine. The five input methods, candidates, learning, handwriting, symbols and cursor controls all still work. What you lose is AI access, paste, handwriting-model updates, and shared image-library archiving.

Does what I type get sent anywhere?

Ordinary input, candidate ranking and learning run on your device and are not sent keystroke by keystroke to KOI servers.

When you explicitly agree to AI sharing and execute a KOI Agent action, it sends your instruction, applicable conversation and the previewed selection/before/after context, capped at 2,000 Unicode scalar values and 4,000 UTF-8 bytes. You can withdraw AI sharing consent in “AI 與 Credits”.

Optional sync sends settings and learning data to your private CloudKit. The App Store version does not enable internal developer diagnostics. See the privacy policy for recipients and retention.

How do I switch between the five input methods?

Choose the Chinese input mode in the KOI app's settings. Cangjie, Quick, Stroke, Jyutping and Zhuyin each have their own keyboard layout.

Does handwriting need a connection?

No. The Hong Kong Traditional Chinese handwriting model is built into the app, so it writes just as well in aeroplane mode. A connection is used only to update the model, and it works without updating.

What if I enter the wrong code or decompose a character wrongly?

KOI may offer near-miss candidates after exact matches. Check them before committing. Press delete twice in succession to clear a composition.

Why can I not type certain characters?

Candidates cover the Han characters in the Basic Multilingual Plane (BMP). A small number of extremely rare extension characters (Unicode Ext B and beyond) are not included yet.

If a character is in common use and you cannot find it, email us with the code you typed and the character you wanted.

I have a new iPhone. How do I move my settings and learning history?

Sync requires Plus, a KOI account and iCloud. Use the same iCloud account on both devices.

Enable sync and trigger it manually in the app. Sync is off by default and does not run in the background.

What are Credits, and when are they spent?

Credits are used only for KOI Agent's AI actions. Everyday typing, candidates and handwriting recognition never cost Credits.

Reply, rewrite and translate cost 1 each, asking a question costs 2, generating a sticker costs 6, and generating an image costs 18.

A subscription grants 250 Credits each month, and each grant is valid for 60 days from the day it is issued; Credit packs bought separately do not expire.

How do I cancel a subscription, and how do refunds work?

To cancel: iOS Settings → your Apple Account → Subscriptions → KOI → Cancel Subscription. You keep access until the end of the current period.

Refunds are handled by Apple, not by KOI. Request one at reportaproblem.apple.com.

Does KOI collect data about how I use it?

KOI services and bundled SDKs process operational, performance, diagnostic and usage data to provide and protect features. KOI uses no advertising identifier or cross-app advertising tracking. See the privacy policy for details and your choices.

Troubleshooting

KOI is missing when I hold the globe key

Usually the keyboard has not been added in iOS Settings — go back to the first step of Getting started. If it has been added and is still missing, restarting the device usually sorts it out.

The AI says the connection failed

Check AI sharing consent, Full Access, your connection and Credits. Open “AI 與 Credits” in the KOI app to review the current state. If it continues, email the error text and app version.

Sync does nothing

Check Plus access, KOI sign-in, iCloud and the sync switch, then trigger sync manually in the app.

Candidate order is not what I want

Check that Personal Learning is enabled. You can manage correction entries under 設定 → 輸入與候選 → 自動更正學習, or clear learning records in settings.

What each AI action costs

Credits are spent only when you ask KOI Agent to do something. Everyday typing, candidates and handwriting recognition never cost Credits.

Image generation costs more to run, so it costs more Credits.
ActionCredits
Reply suggestion1
Rewrite and polish1
Translate1
Ask a question2
Generate a sticker6
Generate an image18

How Credits work

Included with a subscription
Monthly and annual plans both grant 250 Credits each month. An annual plan releases them in twelve grants across the year rather than all at once. Each grant is valid for 60 days from the day it is issued.
Bought separately
Credit packs come in 100, 300 and 800 Credits. They do not expire, and do not include Plus prediction, customization or sync.
When Credits are spent
Only when you ask KOI Agent to do something. Everyday typing does not involve Credits.

Requirements

iOS version
iOS 16.0 or later.
Full Access
AI, clipboard paste, handwriting-model updates, and shared image-library archiving need “Allow Full Access”. Without it, all five input methods, candidates, learning and handwriting keep working exactly as before.
Character coverage
Candidates cover the Han characters in the Basic Multilingual Plane (BMP). Some extremely rare extension characters (Ext B and beyond) cannot be typed yet.
Interface language
The app interface is in Traditional Chinese (Hong Kong).

Contact us

When reporting a problem, please include your iOS version, your KOI version, the input mode you were using, and the steps to reproduce it.