Behind the scenes
How Keebi Decides When to Autocorrect, and When to Leave a Word
By the llcloud team 6 min read
Quick answer
Keebi only replaces a word when every check agrees it is a typo. A real word in any language you type is never replaced, nor is a word you taught it. For an unknown word, Keebi weighs the nearby keys, how common each candidate is and the words before it, and only fixes it when one candidate clearly wins. Any fix undoes in one tap, and Keebi then leaves that word alone for good.
Every autocorrect has to answer the same question thousands of times a day: did you mean what you typed? Most keyboards answer it by guessing the word you probably meant and swapping it in. When the guess is another real word, "we'll" goes out as "well". We built Keebi around the opposite habit. It changes a word only when every check agrees it is a typo, and it treats the word you typed as the most likely thing you meant until proven otherwise. Here is how that decision works, step by step.
Which words does Keebi refuse to touch?
Before Keebi even looks for a fix, it runs through a list of reasons to leave the word alone. Any one of them ends the decision with your word kept as typed.
- The field says no. Search bars, web addresses, email fields, terminals, password and code fields, and number fields never get autocorrect. A "fixed" word in a web address or a command is a broken one.
- You paused it. Private typing stops learning, and the quick switch in the bar stops corrections, until you turn them back on.
- You undid this fix before. If you once undid a correction of this exact word, it sits on a list called Left as you typed, and Keebi never corrects it again.
- It looks deliberate. Words with digits, inner capitals like iPhone, or all capitals are left alone on the default strength.
- It is a real word. This is the big one. A word that is valid in any language you have turned on is never replaced. Neither is a word Keebi learned from you, a word in My dictionary, or a contact name.
- It is very short. On the default strength, Keebi does not correct words under three letters, where a single slip can reach dozens of other words.
The real-word rule is why Keebi exists, and it does not bend. Our guide on stopping iPhone autocorrect changing words explains why other keyboards swap real words, and what you can do about it on Apple's keyboard.
What about contractions like dont and well?
Contractions get their own rules, because some of them look like typos and some look like real words. Keebi sorts them into three groups:
- Not a word on its own. dont, youre, im. These are fixed to don't, you're and I'm, because the bare form is not a word anyone means.
- Usually a contraction. cant and wont. On the default strength Keebi only suggests can't and won't in the bar. On Normal it fixes them.
- Two real words. well and we'll, its and it's, were and we're. Both spellings are words people mean, so Keebi offers the other one in the bar and never applies it on its own.
And an apostrophe you typed is never taken away.
How does Keebi weigh a typo against the word you meant?
When a word passes all those checks, it is unknown: not in any of your languages and not taught by you. Only then does Keebi look for a fix, and even here it starts from the idea that you might have meant it.
It gathers candidate words and scores each one on three things:
- How you could have typed it by mistake. A slip onto a neighbouring key costs little, and the closer the keys, the less it costs. Swapped letters, a missing letter, a doubled letter and a missing accent each have their own cost. When the keyboard knows where your finger landed, a tap on the border between two keys counts for both.
- How common the candidate is. A frequent word is a more likely target than a rare one.
- What came before. The words before this one nudge the likely candidates up, using common word pairs and the ones you type often.
Your own word is in the running too, as the reading "you meant exactly this". That reading gets weaker as the word gets longer, because a long unknown string one slip away from a real word is almost always a typo, while a short one like "thx" is often on purpose.
To win, a fix has to clear two bars. It must beat your own word by a clear margin. And it must be the clear favourite among every plausible reading, holding most of the likelihood on its own. On the default strength that bar is high: a typo like "tht", which could be "the" or "that", is too close to call, so Keebi leaves it and shows both in the bar.
What does the correction strength change?
The strength only moves the bars for unknown words. It never touches the real-word rule. In the Keebi app, under Typing > Correction, you pick one of three:
| Off | Gentle (default) | Normal | |
|---|---|---|---|
| Replaces a real word | ✗ | ✗ | ✗ |
| Fixes clear typos | ✗ | ✓ One slip | ✓ Up to two slips |
| Words with digits, inner capitals or all caps | ✗ | ✗ | ✓ |
| cant to can't | ✗ | Suggested | Fixed |
| Suggestions in the bar | ✓ | ✓ | ✓ |
Gentle fixes a little over half of typical typos in our English tests without changing a single correctly typed dictionary word. Normal fixes about three in four, at the cost of being wrong a little more often on unusual words. Both keep the promise that a real word stays as typed.
When is a word final?
Once you move past it. Keebi only ever changes the word you just finished, and only if you typed all of it since the last space. If you move the cursor, edit an old word or backspace into one, that word is yours and stays that way. Nothing runs when you tap send, go, search or done, so the message you send is the one you see.
What does Keebi learn from you?
It learns words by watching what you keep. When you type the same word the same way three times and neither Keebi nor you fix it, Keebi adds it to your learned words, and from then on it counts as real. You can set that number from one to five in the Words tab, under Learn a word after.
A few things speed it up or stop it:
- Tapping your word as typed in the bar teaches it at once. That tap is the clearest "keep this" there is.
- Deleting a word right after it went in stops it from counting, because a word you take back was not one you meant.
- Never learn is a list for words you do not want suggested, like a typo you keep making.
- Search bars, addresses, email fields and private typing never teach Keebi anything.
Everything it learns stays on your iPhone, and the Words tab shows the whole list, so a word it should not have learned is one swipe away from gone.
How does one tap undo a fix?
Right after Keebi fixes a word, the word you typed waits in the suggestion bar for a few seconds. Tap it, or press delete once, and your word comes back. Keebi then adds it to Left as you typed, and it checks that list before it ever looks for a fix. So one undo keeps that word safe from then on. If you later want Keebi to fix that word again, swipe it off the list in the app.
What can this approach not do?
Keebi will miss some typos, on purpose. When a slip lands on another real word, like "form" for "from", the real-word rule wins and Keebi leaves it. When two fixes are about equally likely, it shows them and lets you pick. We would rather you fix the occasional typo yourself than have a keyboard change the words you meant.
If you are choosing a keyboard, Keebi vs the iPhone keyboard and our list of Gboard alternatives for iPhone compare the options. Keebi's rules work across languages too, which our guide on typing in two languages on iPhone covers, and swipe typing on iPhone shows how to glide with Keebi.
Questions
Will Keebi ever change a word that is spelled correctly?
No. A word that is valid in any language you have turned on is never replaced, at every correction strength. Neither is a word Keebi learned from you, a word in My dictionary or a contact name. The one kind of real-looking word it fixes is a contraction typed without its apostrophe, like dont, which is not a word on its own.
How does Keebi learn a new word?
When you type the same word the same way three times without Keebi or you fixing it, Keebi learns it. You can change that number in the Words tab. Tapping your word as typed in the suggestion bar teaches it at once. Search bars, web addresses, email fields and private typing never teach Keebi anything.
What happens when I undo one of Keebi's fixes?
Your word comes back, and Keebi puts it on its Left as you typed list, so it never makes that correction again. You can undo by tapping your word in the suggestion bar right after the fix, or by pressing delete once. If you change your mind, swipe the word off the list in the app and Keebi may fix it again.
Why did Keebi not fix my typo?
Usually because the typo is also a real word, like form for from, or because two fixes were about equally likely, like tht for the or that. In both cases Keebi leaves your word and shows the options in the suggestion bar instead. Keebi also never corrects in search bars, web addresses, email and code fields, or in a word you already moved past.