Home / User Guide / Typing / Smart Punctuation
Typing P1

Smart Punctuation

Automatic punctuation attachment and spacing


title: Smart Punctuation

description: Automatic punctuation attachment and spacing behavior

category: Typing

difficulty: beginner

related_spec: ../specs/typing/smart-punctuation-spec.md


Smart Punctuation

Smart punctuation automatically attaches punctuation marks to the end of words, removing unnecessary spaces. This creates cleaner text without manual editing.

Quick Summary

WhatDescription

PurposeAttach punctuation to words automatically
AccessSettings > Input Behavior > Smart Punctuation
Works withSwipe typing and suggestion taps

How It Works

When you type punctuation after a word, smart punctuation checks whether the preceding space was auto-inserted (by swipe or suggestion) or manually typed.

Auto-Inserted Spaces

If the space was auto-inserted (from swipe completion or tapping a suggestion), punctuation attaches to the previous word:

Swipe "hello" → type "!" → Result: "hello!"

Manually Typed Spaces

If you explicitly pressed the spacebar, the punctuation stays where you typed it:

Type "hello" → press space → type ":" → Result: "hello :"

This respects your intent when you deliberately add a space before punctuation.

Punctuation Characters

Smart punctuation affects these characters:

CharacterNameBehavior

.PeriodAttaches to word
,CommaAttaches to word
!ExclamationAttaches to word
?Question markAttaches to word
;SemicolonAttaches to word
:ColonAttaches to word
)Close parenthesisAttaches to word
]Close bracketAttaches to word
}Close braceAttaches to word

Quote Handling

Quotes have special handling:

Examples

Swipe Typing Flow

ActionResultExplanation

Swipe "The" → swipe "quick" → type "."The quick. Period attaches + space added for autocap
Swipe "Hello" → type "," → swipe "world"Hello, worldComma attaches to "Hello"
Swipe "Hello" → type "." → swipe "world"Hello. WorldPeriod adds space, next word capitalized

Touch Typing Flow

ActionResultExplanation

Type "Note" → space → type ":" → space → type "text"Note : textManual space preserved
Type "It" → type "'" → type "s"It'sApostrophe handled as contraction

Mixed Flow

ActionResultExplanation

Swipe "hello" → manual space → type "!"hello !Manual space overrides auto behavior
Type "hello" → tap suggestion "world" → type "."hello world.Suggestion's auto-space is removed

Configuration

SettingLocationDefaultDescription

Smart PunctuationSettings > Input BehaviorOnEnable/disable punctuation attachment

Double-Space to Period

A related feature: pressing space twice quickly converts to period + space:

Type "Hello" → space → space → Result: "Hello. "

SettingLocationDefaultDescription

Double Space to PeriodSettings > Gesture TuningOnEnable double-space shortcut
ThresholdSettings > Gesture Tuning500msMax time between spaces

Tips and Tricks

[!TIP]
If you need a space before punctuation (like : in some languages), just press spacebar manually before typing the punctuation.
[!TIP]
Smart punctuation only activates after auto-inserted spaces. Touch-typed text always keeps your exact spacing.
[!NOTE]
Apostrophes in contractions (like "don't", "it's") are never affected by smart punctuation.
[!TIP]
Sentence-ending punctuation (. ! ?) automatically adds a space after attachment, enabling autocapitalization for the next word you type or swipe.

Common Questions

Q: Why does my colon sometimes have a space before it?

A: If you manually pressed spacebar before the colon, CleverKeys respects your intent and keeps the space. This is useful for formatting like Note : important.

Q: Can I disable this for specific punctuation?

A: Currently, smart punctuation is all-or-nothing. You can disable it entirely in Settings > Input Behavior.

Q: Does this work in all apps?

A: Yes, smart punctuation works in any text field. However, some apps may have their own auto-formatting that could interact with it.

Related Features

Technical Details

See Smart Punctuation Technical Specification.

Emoji & Symbols User Dictionary