Mac Dictation Not Working in Confluence? 10 Fixes That Work

Short answer: On a Mac, dictation types wherever Confluence has a blinking cursor, and a page in view mode has none. Press Edit first, then click into the title or body. Most other failures come from the editor itself: slash and mention menus, a draft never published, or an unsaved comment.

You open Confluence on your Mac to write up meeting notes, a project plan or a how-to page while the details are still fresh. You press your dictation shortcut, start talking, and nothing appears on the page. Or a menu pops open halfway through your sentence and swallows three words. Or a paragraph turns into a heading, a teammate's name appears where you never asked for one, or you dictate a whole section, close the tab, and find out the next day that nobody else can see a word of it.

Confluence is a wiki, and a wiki is built around two different activities: reading and editing. Most of the time you are reading, and a page you are reading is not a text field, however much text is on it. When you do switch to editing, you are in a rich editor. It turns certain characters into menus, formatting and mentions as you type, it lets several people work on the same page at once, and on most pages your changes stay out of sight until you publish them. Dictation knows none of that. It needs a live text field with a blinking cursor, and it types into whichever field that happens to be.

So most Confluence dictation problems are about edit mode, focus and saving, not about your microphone. This guide works through every cause in order, starting with the most common. The fixes apply whether you use Confluence in Safari, Chrome or another browser, or in the Confluence desktop app if your organization uses it. If dictation is failing in every app on your Mac and not only in Confluence, our complete guide to Mac dictation not working is the better place to start.

How dictation reaches Confluence on a Mac

Whatever produces your words, Confluence sees them the same way: as text arriving at the cursor, exactly as if you had typed it. On a Mac, that text usually comes from one of two places.

Apple dictation

This is the option built into macOS. You start it with the dictation shortcut, usually the microphone key or a double press of the Fn or Globe key, or from Edit → Start Dictation in the menu bar. macOS handles the audio itself, so Confluence never has to ask for microphone access, and the browser's microphone setting for your Confluence site makes no difference to it. What matters is that a text field has focus when you start.

A third-party dictation app

Menu bar dictation apps, including ours, also type at the cursor. They need their own microphone permission, and usually Accessibility permission, under System Settings → Privacy & Security. They need a live text field to land in too, so everything below about edit mode, focus and menus applies to them as well. One thing is different: you start them with a hotkey you choose, and in a web app with plenty of shortcuts of its own, that choice matters (fix 7).

The 30-second TextEdit test

Before you change any settings, open TextEdit, create a blank document, start dictation and say a sentence.

• If nothing appears in TextEdit either, the problem is dictation on your Mac, not Confluence. Go to fixes 9 and 10.
• If it works in TextEdit but nothing lands in Confluence, the problem is edit mode, focus or the browser. Start at fix 1, then read fixes 2, 3, 7 and 8.
• If your words arrive but get reformatted, disappear into a menu or turn into a name, go to fix 4.
• If text arrives but later goes missing, or your team cannot see it, go to fixes 5 and 6.

Half a minute here saves you from changing settings that were never the problem.

The 10 fixes, in order

1. Switch the page into edit mode

This is the cause behind most "Confluence dictation does nothing" reports. When you open a published page, Confluence shows it for reading. You can click anywhere in the text and nothing becomes editable, because in view mode the page is a document to read, not a field to type in. Dictation has nowhere to go, so your words are dropped.

To edit, click the Edit button, the pencil icon near the top of the page, or press E, which is Confluence's shortcut for editing the page in front of you. The editor opens, with a formatting toolbar across the top and a cursor in the page. Now dictation has somewhere to land. Some newer kinds of Confluence page can be edited in place without an Edit button at all. On those, clicking into the text is enough, and a blinking cursor tells you that you are editing.

Check that you are in the editor by looking, not by typing test characters. When no text field has focus, Confluence treats some single keys as shortcuts, so a stray letter can open search, start creating a page or switch the page into editing. This matters for dictation too, because some dictation tools deliver text as a stream of simulated key presses. If no field has focus, Confluence may read those the same way it reads yours, and a dictated sentence can trigger a string of shortcuts instead of appearing on the page.

2. Click into the title or the body, not the toolbar

Even in edit mode, the cursor is not always where you think it is. A page in the editor has two separate text areas: the title at the top and the body underneath. Around them sit things that look close to text but are not: the toolbar, the page tree in the sidebar, the breadcrumbs and the comments at the bottom. If you last clicked a toolbar button, a menu or the sidebar, focus may still be there instead of on the page, and dictation will not arrive where you expect.

The title is also a single line. It is meant to be a short name you can find later in search and in the page tree, and there is nowhere in it for a second paragraph to go. If you create a new page and simply start talking, everything goes into the title, because that is where the cursor starts. And if you say "new line" or press Return while you are in the title, Confluence moves you down into the body rather than adding a second line, so the rest of your sentence lands on the page, split from its first half.

The rule of thumb: say a short name into the title, then click into the body and talk through the content there. If a title has already swallowed a paragraph, cut everything after the first phrase and paste it into the body.

3. Make sure you can edit the page

If the Edit button is missing or the editor never opens, you may not have permission to change this page. Confluence lets space admins and page owners restrict who can view a page and who can edit it, and some people can only read a whole space. Without edit rights there is no editor, and no amount of dictation troubleshooting will change that.

Look near the top of the page for a restrictions indicator, usually a padlock, which shows whether the page is restricted. If it is, ask the page owner or a space admin for edit access. If you can comment but not edit, you can still dictate a comment (fix 6), which is often enough to suggest the change you had in mind. Restrictions can also be inherited from a parent page, so a page that looks open can still be locked because of where it sits in the tree.

4. Watch for slash menus, mentions and markdown

Confluence's editor formats as you type. A slash opens a menu of things to insert, such as tables, panels, dividers and macros, and while that menu is open, your next words are treated as a search for an item in it. An at sign opens a picker for mentioning a teammate, and whatever you say next becomes a search for a person. A colon followed directly by letters can open an emoji picker. Some characters at the start of a line are read as markdown: a hash sign followed by a space can turn the line into a heading, a dash or an asterisk can start a bulleted list, a number followed by a full stop can start a numbered one, and a pair of square brackets can create an action item with a checkbox.

Dictation produces these characters when you say their names, and it also produces them from things you might not expect. An email address brings an at sign with it, saying "slash" gives you the character itself, and a line that begins with a number and a full stop, which is how dictated numbered points often arrive, can become a numbered list. You have not lost anything when this happens. It is formatting, not deletion.

If a menu or picker opens, press Escape once to close it, or undo with Cmd+Z, then carry on. If a line has turned into a heading, a list or an action item you did not want, undo straight away, which usually removes the formatting and keeps your words. For mentions, it is easiest to dictate the sentence first, then type the @ and pick the person by hand. Our guide to dictating quotes and special characters covers how to say symbols when you actually want them.

5. Publish the page, and check who else is editing

This fix is for words that arrived but never reached anyone. When you edit a page in Confluence, your changes are kept as you go, but on most pages readers only see them once you publish, with the Publish or Update button at the top of the editor. Until then, everyone else sees the previous version, and a brand-new page exists only as your draft.

It is easy to dictate a long section, close the tab and assume the page is done. Confluence normally holds on to unpublished changes, so they are rarely lost, but nobody else can see them. If a page you wrote seems to have vanished, look in your drafts, which Confluence lists alongside the rest of your recent work, and publish it from there. If you open the editor on a page you left halfway through, your unpublished changes are usually still waiting.

Collaborative editing adds a wrinkle. Several people can be in the editor on the same page at once, and each of them appears near the top of the editor while they are there. Changes from everyone in the editor are published together, so if a colleague publishes while you are still dictating, your half-finished paragraph can go out with their changes. And if someone deletes or moves the section you are dictating into, your words go with it. Before a long dictation session on a busy page, check who else is editing, and publish in a sensible state rather than mid-sentence.

6. Open and save your comments properly

Comments are a small version of the same problem. Page comments sit at the bottom of the page, and inline comments attach to a piece of text you highlight. Either way, what you dictate into a comment box is a draft until you save it with the button underneath. Scroll away, close the page or open another comment, and an unsaved comment may not survive.

Inline comments need one extra step before you can dictate at all. Highlight the text you want to comment on, then click the comment button that appears beside it. Only then does a comment box open with a cursor. Be careful if you are in edit mode: if you start dictating while text is still highlighted and no comment box has opened, dictation replaces the highlighted text, just as typing would. Undo with Cmd+Z straight away if that happens, then open the comment box and try again.

The fix is a habit rather than a setting: read what you dictated, save it, and only then move on.

7. Pick a dictation shortcut Confluence does not use

If you start dictation with a hotkey, check that neither Confluence nor your browser claims the same keys. The editor has shortcuts for bold, italics, links, headings, lists and more, many of them combinations with Cmd, Option and Shift, and while it has focus it may react to a key press before, or as well as, your dictation tool. The symptoms are confusing: dictation starts in other apps but not in Confluence, or it starts and your text turns bold or a link box opens at the same moment.

Apple dictation's default shortcuts, the microphone key and a double press of Fn or Globe, rarely clash. Custom shortcuts are where the trouble starts. If you have set your own, or you use a dictation app with a hotkey you picked, change it to something the editor leaves alone, such as a single modifier key, and test again. Confluence keeps a list of its keyboard shortcuts in its help menu, so you can check a combination before you choose it. Our guide to a Mac dictation shortcut that is not working covers the macOS side of choosing one.

8. Rule out browser extensions and connection trouble

Grammar checkers, writing assistants, password managers and translation tools attach themselves to text fields in your browser. Usually that is harmless, but some intercept input or draw overlays that confuse focus, especially in rich editors like Confluence's, which already have toolbars and pop-up menus of their own. Some extensions also add keyboard shortcuts that collide with the editor's.

To test, open the same page in a private window, where most extensions are off by default, in a different browser, or in the Confluence desktop app if you have it. If dictation works there, turn your extensions back on one at a time in your usual browser to find the culprit. If it fails everywhere, the cause is on the Mac side, and fixes 9 and 10 are more likely to help. If Chrome is your browser and dictation misbehaves in other web apps too, our guide to Mac dictation not working in Chrome may be the quicker fix.

A weak connection can look like broken dictation too. The editor keeps your changes in step with everyone else's over the network, and when the connection drops it may warn you, pause, or show text arriving late. If the editor shows a connection warning, stop dictating until it clears, and reload the page if it does not. Then check that the last thing you said actually made it onto the page.

9. Clear Secure Input

macOS has a protection called Secure Input that stops apps from reading keystrokes while you type a password. While it is on, dictation cannot deliver text into other apps. Some apps turn it on and forget to turn it off, and macOS gives no obvious sign that it is still active.

Password managers are the usual cause, along with a Terminal window sitting at a password prompt or an app showing a login screen. Many companies put Confluence behind a single sign-on page, so a password manager that filled in your company login is a common suspect. Finish or close those prompts, click into a text field in another app, and test dictation there. If it still fails everywhere, log out of your Mac account and back in, which clears it. If the problem started right after you signed in, quitting and reopening the browser is often enough.

10. Check your microphone and dictation settings

If dictation fails in TextEdit too, work through the Mac side:

• Dictation is on. Open System Settings → Keyboard and make sure Dictation is switched on, with the shortcut you expect.
• The right microphone is selected. Dictation has its own microphone source setting in the same place. Choose the microphone you are speaking into, then open System Settings → Sound → Input and watch the level meter move as you talk.
• Nothing else is holding the microphone. A video call, a screen recorder or a meeting app running in the background can keep the microphone busy. The microphone indicator in the menu bar and Control Center shows which app is using it.
• Bluetooth headsets are awake. Headphones sometimes connect for listening without making their microphone available. Switch to the Mac's built-in microphone to test.
• The language matches. If text arrives but is consistently wrong, check that the dictation language, including the regional variant, matches the way you speak.

If all of that looks right, restart your Mac. It clears stuck dictation processes and resets audio devices in one step.

Confluence quirks that look like broken dictation

• Long sections get cut off. Apple dictation ends a session on its own after a pause it reads as the end of what you meant to say, and on some setups after a stretch of continuous speech. A page of meeting notes easily runs past that point. Our guide to the Mac dictation 30-second limit covers the workarounds.
• Words land in the wrong table cell. Each cell in a table is its own small text area, and the cursor stays in whichever cell you clicked last. Saying "new line" adds a line inside that cell rather than moving to the next one, so click each cell before you speak into it.
• Text ends up inside a panel or code block. If the cursor was inside a panel, an expand section or a code block when you started, everything you say goes in there too. Click below the element, or use the arrow keys to move out of it, before you carry on.
• A heading swallowed a paragraph. The cursor was on a heading line when you started, and everything you said took on that style. Put the cursor in a normal paragraph, or set the text style back to normal from the toolbar.
• Issue keys, product names and acronyms come out wrong. Jira keys, service names and internal shorthand are the words general dictation handles worst, and Apple dictation has no way to learn them. Paste or type those. If your team writes up work in Jira too, our guide to Mac dictation not working in Jira covers the same kinds of problems there.
• Punctuation is missing. Apple dictation adds some punctuation on its own, and you can say "comma", "period" or "question mark" to place it exactly.

Quick reference

• Nothing happens on an open page: it is in view mode. Fix 1.
• Nothing happens in the editor: focus is on the toolbar, a menu or the sidebar. Fix 2.
• The title ate the whole paragraph: one line only. Fix 2.
• No Edit button at all: page restrictions. Fix 3.
• A line became a heading, a list or a checkbox: markdown. Fix 4.
• Words vanished into a menu or became a name: the slash menu or the mention picker. Fix 4.
• Your team cannot see your changes: the page was never published. Fix 5.
• A comment disappeared: it was never saved. Fix 6.
• Dictation starts everywhere except Confluence: a shortcut clash. Fix 7.
• Works in a private window but not normally: an extension. Fix 8.
• Stopped working everywhere today: Secure Input. Fix 9.
• Fails in TextEdit too: Mac settings. Fix 10.

Why Confluence is harder to dictate into than a document

In a word processor, the page is always editable. Click anywhere and talk, and your words appear. Confluence works differently because most visits to a wiki page are reads, not writes, so it shows pages for reading and makes editing a deliberate step. Once you are editing, the page is not really one big text box but a stack of blocks, such as paragraphs, headings, tables, panels and macros, each with its own rules. On top of that, the page is shared: other people can be editing it with you, and what you write is a draft until someone publishes it.

None of that is a flaw. It is what makes Confluence good at holding a team's knowledge in one place without people treading on each other's work. It is also why dictation fails there in ways it never fails in an email. The good news is that the rules are consistent. Once you know to open the editor first, where the cursor needs to be, which characters the editor treats specially and when your words become visible, the problems become predictable, and so do the fixes.

A dictation workflow that suits Confluence

• Edit first, then title. Press E or click Edit, say a short title, then click into the body.
• Lay out headings by hand. Add a few section headings from the toolbar, then click under each one and dictate. A clear target for every section keeps your words where they belong and markdown surprises to a minimum.
• Talk each section through. Say it the way you would explain it to a colleague who missed the meeting. It is easier to tidy spoken paragraphs than to fill an empty page.
• Paste the exact parts. Links, issue keys, figures and code are faster and safer to paste than to speak.
• Insert tables and macros afterwards. Use the slash menu once you have finished talking, so it never opens in the middle of a sentence.
• Publish, then read the published page. Check it the way your readers will see it.

It is worth the effort 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. Documentation is where that gap matters most. The page that takes an hour to type often never gets written at all, while the same page spoken aloud takes a fraction of the time. Our guide to dictation for project documentation covers how to structure longer pages, and our guide to dictating Confluence pages by voice walks through the setup.

A dictation tool built for work like this

Apple dictation is free and built in, and for many people one of the fixes above is all they need. If you write pages and meeting notes every day, though, its limits start to show: sessions that end halfway through a section, and product names and acronyms it has no way to learn.

Voice Keyboard Pro is a Mac app that lives in your menu bar. Hold a hotkey, speak, release, and the text appears at your cursor, system-wide. In Confluence that means a page title, a section of the body, a table cell or a comment, in the browser or the desktop app. It still needs a live text field, so fixes 1 to 6 still apply, and because you choose its hotkey, pick one the editor does not use (fix 7). After that, the experience is different:

• It listens for as long as you hold the key. A pause to think does not end the session, so you can talk through a full section in one go.
• Smart Vocabulary is a personal dictionary with replacement rules. Add your product names, project codenames and team acronyms once, and they come out spelled correctly every time.
• Meeting Mode records meetings with speaker detection and produces AI notes, and calendar meeting detection helps you catch the meetings you want to capture. Those notes are a short step from a Confluence page, which is where a lot of meeting notes end up anyway.

On privacy, our servers store only operational pings. No audio and no transcript content is stored, which matters when your pages describe internal plans. There is a free tier with daily limits, and Pro is $4.99 a month or $34.99 a year. If you also read and comment on pages from your phone, the iPhone app is a custom keyboard with a built-in mic button that works in any iOS app, the Confluence app included.

Frequently asked questions

Why does nothing happen when I dictate in Confluence?

The page is most likely in view mode, which has no text field. Click the Edit button or press E to open the editor, then click into the title or body until a blinking cursor appears, and dictate.

Why can't my team see what I dictated?

Your changes are still a draft. On most Confluence pages, readers only see edits after you click Publish or Update at the top of the editor. If you closed the page, look for it in your drafts and publish from there.

Why do my dictated lines keep turning into headings or lists?

Confluence's editor reads markdown as you type. A hash sign, a dash or a number with a full stop at the start of a line can reformat it. Undo straight away to keep the words without the formatting.

Does Confluence need microphone permission for dictation?

Not for Apple dictation, which macOS handles on its own, and your browser's microphone setting for Confluence does not affect it. Third-party dictation apps need their own microphone permission in System Settings, not a permission from Confluence.

Do the same fixes work for Confluence on iPhone?

Most of them. You still need to be editing, with a cursor in the page, and the editor still reacts to slash, at signs and markdown. On iPhone you dictate with the mic on your keyboard rather than a Mac shortcut, so if the keyboard does not appear, you are not editing yet.

What to do next

Run the 30-second TextEdit test, then work through the fixes that match what you saw. For most people it is fix 1: the page was open, but not in the editor. If words turned into formatting or disappeared into a menu, it is fix 4, and if your team cannot see what you wrote, it is fix 5. If dictation works everywhere except Confluence, check your shortcut in fix 7, and if it stopped working everywhere at once, try fix 9 before anything else. And if you want dictation that keeps listening through a full section and learns your team's vocabulary, try Voice Keyboard Pro's free tier on your next page.