How to keep line breaks in iPhone Text Replacement
Text Replacement is great for a short phrase like your email address. Try to save something with more than one line, like a postal address, a signature, or a short template, and the line breaks usually vanish. The text comes out as one long run-on line. Here is why that happens, the workaround people use, and a more dependable way to keep multi-line text one tap away.
Quick answer
The Phrase field in iPhone Text Replacement is a single-line field, so you can't press Return to start a new line, and multi-line text pasted into it generally loses its breaks. The common workaround is to create the replacement on a Mac, where Option-Return adds a line break, and let it sync to your iPhone through iCloud, but people report mixed results. If you rely on multi-line snippets, save them as keys in a custom keyboard like WordBoard instead, which inserts the text exactly as you saved it, line breaks included.
Why Text Replacement loses line breaks
Text Replacement lives in Settings, General, Keyboard, Text Replacement. Each entry has a Phrase and a Shortcut, and both are plain single-line fields. Apple designed the feature for short expansions: an email address, a phone number, a word you always misspell.
That design shows up in a few ways:
- No Return in the Phrase field. There is no way to type a new line while editing the phrase on iPhone.
- Pasting flattens the text. Copy a multi-line address from Notes and paste it into the Phrase field, and it typically lands as one line. Forum threads going back years describe the same thing.
- Long phrases are fragile. Longer entries are where Text Replacement is least dependable in general. Our guide to fixing iPhone Text Replacement covers the other common causes when shortcuts stop expanding.
The Mac workaround (and its limits)
If you have a Mac signed in to the same Apple Account, you can try creating the entry there:
- On your Mac, open System Settings, then Keyboard, then Text Replacements.
- Click + to add a new entry.
- In the With column, type the first line, press Option-Return to add a line break, and continue.
- Give it a shortcut, then wait for it to sync to your iPhone through iCloud.
Treat this as worth a try rather than a guaranteed fix. Users report that some entries keep their breaks on iPhone while others arrive flattened, that sync can be slow or stall, and that editing the entry later on the iPhone can strip the breaks again. It also doesn't help if you don't have a Mac.
A dependable alternative: multi-line keys in WordBoard
WordBoard is a custom keyboard where your saved text appears as labelled keys. You write each snippet in the WordBoard app, where you can type or paste text over as many lines as you need. When you tap the key, the full text is inserted at your cursor, line breaks included, in any app.
- Open WordBoard and create a new key.
- Give it a clear label, like "Home address" or "Signature: full".
- Type or paste the text with its line breaks.
- In any app, switch to WordBoard with the globe key and tap the key.
There is no shortcut to remember, so autocorrect has nothing to interfere with, and you can group keys into folders by client, project, or type. If you want your cursor to land in a specific spot after the text goes in, such as after "Hi " at the top of a template, add the {{ CURSOR }} variable there. Our guide to iPhone keyboard variables explains how it works.
Multi-line snippets worth saving
- Postal addresses: home, work, and delivery addresses in the right layout. See contact details on your iPhone keyboard.
- Email signatures: a full block for new contacts and a short one for replies. See multiple email signatures on iPhone.
- Email and message templates: greeting, body, and sign-off laid out properly. See email templates on iPhone.
- Lists and instructions: directions, packing lists, or step-by-step replies you send often.
- Support answers: structured replies with a clear opening and next steps. See canned responses on iPhone.
Already using Text Replacement for short phrases? Keep it for those. It works well for one-line expansions, and WordBoard can sit alongside it for the longer text. WordBoard is free to download with 6 keys included. WordBoard Pro unlocks unlimited keys.
FAQ
Can you add a line break in iPhone Text Replacement?
Not directly on iPhone. The Phrase field is single-line, so there is no Return key, and pasted multi-line text usually loses its breaks. Some people create the entry on a Mac using Option-Return and sync it to the iPhone through iCloud, with mixed results.
Why does my multi-line text replacement come out on one line?
Text Replacement was designed for short, single-line phrases. When multi-line text is pasted into the Phrase field on iPhone, the line breaks are typically removed, so the expansion is inserted as one long line.
How do I make a text replacement with multiple lines on a Mac?
Open System Settings, Keyboard, Text Replacements, click +, and press Option-Return in the replacement text wherever you want a new line. The entry syncs to your iPhone through iCloud, but people report that line breaks don't always survive on the iPhone.
What is the best way to save a multi-line address on iPhone?
Save it as a key in a custom keyboard like WordBoard. You type or paste the address with its line breaks once, then tap the labelled key in any app to insert it exactly as saved. WordBoard Pro is required for unlimited keys.
Does WordBoard replace Text Replacement?
It doesn't have to. Text Replacement still works with Apple's keyboard for short shortcuts you type. WordBoard is a separate keyboard you switch to when you want to tap longer or multi-line text, and the two can be used side by side.