← Back to Blog

Short answer: If dictation works in other Mac apps but not in WordPress, click inside a paragraph block until the cursor blinks, not the title, sidebar or a selected block. Then check you are in the visual editor, close any slash menu or link box, and confirm your login has not expired.

Free to start Dictate into any app on your Mac or iPhone — hold a key, speak, release. Download for MaciPhone

You have a post to write, WordPress is open, and you would rather say the first draft than type it. You press your dictation shortcut, speak a paragraph, and nothing appears. Or the words turn up in the title. Or in the Tags box, chopped into six tags. Or your sentence lands in the middle of a wall of HTML, and the editor announces that a block contains unexpected or invalid content. Or dictation works in every other app on your Mac and does nothing at all in the WordPress editor.

WordPress is not a single text box. The block editor is a page of separate blocks, with a title field above them, a settings sidebar beside them and a toolbar that opens small pop-up fields of its own, all running inside a browser tab. Dictation, whether it is Apple's or a dictation app's, delivers text to whatever has keyboard focus, as if you had typed it. WordPress then does what it always does with typed text: it starts new blocks, filters menus, turns certain characters into formatting, and files your words into whichever field happened to be active.

So most WordPress dictation problems are about where your words landed and what the editor did with them, not about your microphone. This guide works through every cause in order, starting with the most common one. If dictation is failing in every app on your Mac and not only in WordPress, start with our complete guide to Mac dictation not working instead.

How dictation reaches WordPress

Apple dictation is built into macOS. You start it with the dictation shortcut, usually the microphone key or whichever shortcut is set in System Settings under Keyboard, or from Edit, then Start Dictation in your browser's menu bar. It sends its text to whichever field has keyboard focus. WordPress has no microphone button and no dictation setting of its own, and your site does not need microphone permission for Apple dictation to work, because it is your Mac that is listening, not the web page. If your browser asks whether a site may use the microphone, that request is coming from a web-based voice tool or a plugin, not from Apple dictation.

Menu bar dictation apps, including ours, look much the same from WordPress's side. They put text at your cursor, and many of them deliver it the way a paste does. They need their own Microphone permission, plus Accessibility permission to put text into other apps, under System Settings, then Privacy & Security. Neither WordPress nor your browser needs anything extra.

That leaves one big rule: dictated text goes to whatever has focus, and the editor treats it exactly like typing. A sentence in a paragraph block is a sentence. The same sentence in the Tags box is a handful of tags, and in the code editor it is a line of stray text in the middle of your markup.

The 30-second test

Before you change anything, open TextEdit, create a blank document, start dictation and say a sentence. Then go back to WordPress, start a new draft, click the empty line under the title where the editor invites you to type, and dictate the same sentence.

Command-Z is your friend throughout this guide. The editor's undo takes back dictated text like any other edit, so if a paragraph lands somewhere it should not, undo it before you try to repair it by hand.

The 10 fixes, in order

1. Click inside a paragraph block until you see the cursor

This is the cause behind most "dictation does nothing in WordPress" reports. The editor screen has a title field, the content area, a settings sidebar, a top toolbar, and optional panels such as the block inserter and the document outline. Only one of them has keyboard focus at a time, and it is frequently not the one you are looking at.

The title is the classic trap. A new post opens with focus in the title field, so a dictated opening paragraph becomes a very long headline. The sidebar is the next one. After you set a category, a featured image or an excerpt, focus stays in the sidebar, and the next thing you say goes into whichever box you last clicked: the excerpt, the URL slug, the Tags box, or the alt text of an image.

A selected block is not the same as a cursor in a block, either. Clicking an image, a spacer, a separator or a set of columns selects that block and shows an outline around it, but there is no text field in it, so there is nowhere for words to go. In many setups the content area is also loaded as its own frame inside the page, so clicking the grey space around your post does not put focus in the text.

Click directly in the paragraph where you want the text and look for the blinking insertion point before you speak. If you want a new paragraph, click at the end of the previous one and press Return first, so there is an empty block waiting for your words.

2. Leave select mode and clear multi-block selections

The block editor has two ways of responding to the keyboard. In one you are editing text. In the other you are selecting and moving between blocks, and letters do not go into your post. Pressing Escape while you are typing in a block is the usual way people switch from the first to the second without meaning to, and some versions also offer the choice in a Tools menu in the top toolbar. If a block has an outline around it but no blinking cursor inside, press Return or click in the text to start editing again.

Multi-block selections cause the opposite problem. Dragging across several paragraphs, Shift-clicking a second block, or pressing Command-A twice selects whole blocks, not just the text in one of them. Anything typed while several blocks are selected can replace all of them, and dictation counts as typing. If three paragraphs disappeared and one sentence took their place, undo straight away, click once in a single block so that only a cursor remains, and dictate again.

3. Check you are in the visual editor, not the code editor

WordPress can show the same post in two forms. The visual editor shows blocks the way they will roughly look when published. The code editor shows the whole post as one plain-text field of HTML, with a comment line marking where each block begins and ends. You switch between them from the Options menu, the three dots at the top right of the editor, or with Shift-Option-Command-M.

In the code editor, dictation still works, but your words go in as raw text wherever the cursor is. If they land inside a tag, or between a block's markers and its content, WordPress cannot match the markup to the block when you return to the visual editor, and it shows a notice that the block contains unexpected or invalid content, with an option to attempt recovery. Switch back to the visual editor from the same Options menu, undo the stray text if you can, and dictate into a paragraph block.

A few block types behave like small code editors even in the visual editor. Custom HTML, Code, Preformatted and Shortcode blocks take text literally and do not turn it into formatted paragraphs. If your sentence appeared in a monospaced font or did not show up on the published page, check which kind of block you were in. On sites that use the Classic Editor plugin, the same idea applies to its two tabs: the Visual tab is for writing, and the Text tab, called Code in some versions, shows the HTML.

4. Close pop-up fields first: the slash menu, the link box, the command palette

The block editor opens small text fields on top of your post, and each of them will take every word you say.

In every one of these cases dictation worked. It just filled in a search. Close the pop-up with one press of Escape, or by clicking in your post, and check for the cursor in a block. Press Escape only once, because a second press can put the editor into the select mode described in fix 2.

5. Understand what WordPress does with line breaks and shortcuts

In the block editor, the Return key does not add a line break. It ends the current block and starts a new paragraph block. So when you say "new paragraph", or your dictation app delivers several paragraphs at once, the text arrives as several blocks. That is normal and usually what you want, since each block can then be moved, styled or deleted independently. If you want a line break inside a single block, for an address or a few lines of verse, add it by hand with Shift-Return.

Different blocks treat a line break differently:

The editor also has typing shortcuts. A line that starts with a hyphen and a space becomes a bulleted list. A number followed by a full stop and a space becomes a numbered list. One or more hash signs and a space become a heading, and a greater-than sign and a space become a quote. If your dictated text happens to begin with one of those patterns, such as a sentence that opens with "1." because you are dictating numbered steps, WordPress may convert the block. Pressing Command-Z immediately after the conversion reverses it and leaves the characters as you said them. When several lines arrive at once, the editor may also read list markers and similar patterns in them and build the matching blocks for you.

The practical habit is simple: dictate one section at a time into an ordinary paragraph block, then turn paragraphs into headings or lists afterwards using the block toolbar.

6. Make sure the block can be edited

Sometimes the cursor will not go where you click, because that part of the page is not open for editing.

The check is always the same. If there is no blinking insertion point, there is nowhere for dictated text to go. Unlock or open the item for editing first, look for the cursor, then speak.

7. Sign back in when your session expires

WordPress logs you out after a period of time, and if the editor is open when that happens it places a login box over the page with a message that your session has expired. If you were looking at your notes instead of the screen, you can dictate a full paragraph that goes nowhere, because the editor behind the box is not accepting input.

There is a second effect for dictation apps. While a password field is active, macOS uses Secure Input, which stops other apps from reading or sending keystrokes. A dictation app may not see its hotkey, or may not be able to deliver its text, for as long as the cursor sits in that password box. A password manager prompt can have the same effect. Sign in, let the login box close, click back into your block and try again. Your unsaved work is normally still there underneath.

8. Dictated text vanished? Check saves, autosaves and revisions

Words that appeared and then disappeared were usually never saved, or were overwritten.

The block editor saves a draft automatically from time to time, and it also keeps a backup in your browser. If you reopen a post and see a notice that the backup in your browser is different from the version shown, choose to restore the backup before you do anything else, because that backup is often the text you thought you had lost.

If you see "Updating failed" or "Publishing failed", your text is still in the editor but has not reached the server. Do not reload the page. Switch to the code editor, select everything, copy it somewhere safe such as a TextEdit document, and then sort out the connection or the login.

The same post open in two browser tabs, or by two people, is another way to lose a paragraph, because the tab that saves last wins. Close the duplicates. And if a saved version of your text existed at any point, look for Revisions in the Post tab of the sidebar. You can browse earlier versions there and restore the one that has your dictation in it.

9. Rule out the browser, extensions and your dictation app's permissions

WordPress runs in a browser, so the browser is part of the problem space. Open the same post in a private window, or in a different browser, and dictate there. If it works, something in your everyday browser profile is interfering.

Extensions are the usual suspects. Writing assistants and grammar checkers attach themselves to editable text fields, and they can reposition the cursor or rewrite text as it arrives. Script and ad blockers can stop parts of the editor from loading at all. Disable extensions one at a time until dictation behaves. Our guides to Mac dictation not working in Chrome and in Safari cover the browser-specific causes.

Shortcuts are worth a look too. Browsers and the WordPress editor both use a large number of key combinations. If your dictation shortcut matches one of them, the browser may act on it first. Our guide to a Mac dictation shortcut that is not working walks through finding conflicts.

If you use a dictation app, check its two permissions under System Settings, then Privacy & Security: Microphone, so it can hear you, and Accessibility, so it can put text into your browser. After you grant a permission, quit the app and open it again. Then check the microphone itself. A video call or a screen recorder can keep hold of it, and a headset that was unplugged can leave your Mac listening to the wrong input. Our guide to Mac dictation microphone problems covers the input side in detail.

10. Check dictation on your Mac

If dictation failed in TextEdit too, WordPress is not the problem. Open System Settings, go to Keyboard, and make sure Dictation is on. Check which shortcut it uses, and make sure the dictation language matches the language you are speaking. Then restart your Mac, which clears stuck dictation services in one step. If dictation stopped working straight after an upgrade, our guide to Mac dictation not working after a macOS update covers what tends to change.

WordPress quirks that look like broken dictation

Quick triage

Where dictation earns its place in WordPress

Nobody should try to build a page layout by voice. Choosing blocks, placing images and setting up columns are quicker with the mouse. What dictation is good at is everything written in sentences, and a WordPress site has more of that than the post body alone:

The rule that keeps all of it tidy: say the sentences, click the structure. Dictate into plain paragraph blocks, then add headings, lists, images and links by hand once the words are down.

It is worth getting right, because speaking is much faster than typing. Most adults type around 40 words per minute, and even professional typists usually sit around 80 to 100, while normal speech runs at 130 to 150 words per minute. For anyone who publishes regularly, the first draft is where most of the time goes, and it is the part that suits speaking best. Our guide to voice typing in WordPress covers the day-to-day workflow once everything is working, and voice to text for bloggers looks at drafting habits more broadly.

WordPress versus other block-based editors

The same principles apply wherever a page is made of blocks: focus decides where words go, and the editor decides what a line break means. The details differ from tool to tool. If you also draft in Notion, our guide to Mac dictation not working in Notion covers its slash menu, databases and page titles, which fail in ways a WordPress user will recognise.

Dictation that works in every field

Apple dictation is free and built in, but it stops after a pause, it depends on settings that are easy to switch off by accident, and fixing a misheard word means going back and editing by hand.

Voice Keyboard Pro is a menu bar app for Mac. Click where you want the text, hold your hotkey, speak, and release. The text appears at your cursor, system-wide, in a WordPress paragraph block, in the excerpt field, in your email and in every other app you use. The microphone stays live while you hold the key, so a pause to think about your next sentence does not end the session. Like any dictation app, it puts text wherever focus is, and WordPress still decides what that text means, so fixes 1 to 8 still apply.

A few features help with publishing work in particular:

On privacy, our servers store only operational pings. No audio and no transcript content is stored, which matters when what you are dictating is an unpublished draft. There is a free tier with daily limits, and Pro is $4.99 a month or $34.99 a year. On iPhone, the same product is a custom keyboard with a built-in mic button, so you can dictate in any iOS app too.

Frequently asked questions

Does WordPress have its own dictation setting?

No. WordPress relies on the dictation built into macOS or on a dictation app. Both deliver text to whatever has keyboard focus, and there is nothing inside WordPress to turn on.

Why does dictation work in TextEdit but not in WordPress?

Almost always because focus is somewhere other than a text block: the title, the sidebar, a search box, or a block that is selected but not being edited. Click in a paragraph until you see the cursor. If the cursor will not appear, check whether the block is locked, whether someone else is editing the post, or whether a login box is covering the page.

Why did my dictation split into several blocks?

In the block editor, every paragraph is its own block and a line break starts a new one. Dictation that contains paragraph breaks therefore arrives as several blocks. That is how the editor is designed to work, and the published post reads as ordinary paragraphs.

Why does WordPress say a block contains unexpected or invalid content?

Text was added in the code editor in a place that broke the block's markup. Switch back to the visual editor, undo the change if you can, or use the recovery option the notice offers, then dictate into a paragraph block.

Does my website need microphone permission for dictation?

Not for Apple dictation or for a Mac dictation app. Both listen through macOS and type into the page, so the site never touches the microphone. Only web-based voice tools that run inside the page need the browser's microphone permission.

Does dictation work in the Classic Editor and in page builders?

Yes, as long as a text field has focus. In the Classic Editor, write in the Visual tab. In a page builder, open the builder's own editor and click into the text, either in its panel or on the canvas, until you see the cursor.

What to do next

Run the 30-second test, then work through the fixes that match what you saw. For most people it is fix 1: the cursor was not in a paragraph block, and the words went to the title, the sidebar or nowhere. If your words arrived and something strange happened, it is almost always fix 3, 4 or 5: the code editor, a pop-up field or a line break did what WordPress told it to. And if you want dictation that stays out of your way in WordPress and everywhere else on your Mac, try Voice Keyboard Pro's free tier on your next draft.

Voice Keyboard Pro
Hold your key · Speak · Release

The words land at your cursor in whatever app you are already in — Mail, Slack, Word, a browser form. No dictation window, nothing to copy across.

Free forever for casual use · Apple Silicon & Intel