Blogging & content · Guide
How to Add Footnotes in WordPress

Short answer
Add footnotes in WordPress with the built-in Footnotes block or the free Modern Footnotes plugin. Highlight a word, pick Footnote in the block toolbar, and type the note in the list at the bottom of the post. With Modern Footnotes, wrap the note in the [mfn] shortcode instead.
Key takeaways
- The built-in Footnotes block arrived in Gutenberg 16.1 and shipped with WordPress 6.3.
- Modern Footnotes uses the [mfn] shortcode and numbers notes in order on its own.
- On desktop, Modern Footnotes notes show as tooltips; on mobile, they expand below the text.
- Use [mfn_list] or the plugin setting to show a footnote list at the bottom.
- Keep each footnote to one or two sentences and put key facts in the main text.
- Never mix the built-in block and Modern Footnotes on the same post.
What are footnotes in WordPress?
Footnotes are small numbered notes that add extra detail without breaking the flow of a post.
A reader clicks a small number in the text and reads the note, then keeps reading. The note can hold a source, a definition, or a short aside that would clutter the main text.
WordPress has 2 ways to add them. The block editor has a built-in Footnotes block, and the free Modern Footnotes plugin adds tooltip-style notes. Pick the built-in block for simple notes, and the plugin when you want more control over how notes look.
Footnotes suit posts that cite sources, define terms, or add background. They do not suit short posts with no claims to back up. If a note is longer than 2 or 3 sentences, put it in the main text instead.
| Method | How a reader sees the note | Numbering | Cost |
|---|---|---|---|
| Built-in Footnotes block | Jumps to a list at the bottom of the post | Automatic, reorders as you edit | Free, built into WordPress |
| Modern Footnotes plugin | Tooltip on desktop, expands below the text on mobile | Automatic, with manual options | Free plugin |
How do you add footnotes with the built-in Footnotes block?
Highlight the word you want to note, open the block toolbar menu, and pick “Footnote”.
The Footnotes block arrived in Gutenberg 16.1, which was released on 29 June 2023, according to the Make WordPress Core post (checked November 2026). Gutenberg 16.1 says footnotes work in text blocks such as paragraphs, headings, and lists, and the block removes and reorders footnotes as you edit.
- Open a post or page in the block editor.
- Click the paragraph that holds the word you want to note.
- Highlight the word or short phrase.
- Click the dropdown arrow in the block toolbar.
- Select Footnote.
- Type the note text in the Footnotes block at the bottom of the post.
WordPress numbers each footnote on its own, in order, from 1 up. If you add a new note above an old one, the numbers change to match. You do not need to renumber anything by hand.
The Footnotes block also shipped with WordPress 6.3, according to the WordPress developer news for July 2023 (checked November 2026). Developer news for July 2023 says the block lets you insert a footnote link in any RichText area and edit each note in the list at the bottom of the post.
How do you add footnotes with Modern Footnotes?
Install the Modern Footnotes plugin, then wrap each note in the [mfn] shortcode or use the footnote button in the editor toolbar.
Modern Footnotes is a free plugin on WordPress.org, first published on 9 April 2017, according to its WordPress.org page (checked November 2026). Modern Footnotes numbers notes in order on its own, so the first note is 1, the next is 2, and so on.
- Go to Plugins > Add New, search for “Modern Footnotes”, and click Install Now, then Activate.
- Open a post in the block editor.
- Type the shortcode
[mfn]right after the word you want to note. - Type the note text, then close it with
[/mfn]. - Repeat for each note, then preview the post.
You can also use the footnote button in the editor toolbar instead of typing the shortcode. Highlight the text, click the button, and pick the footnote option. The plugin moves the text into a footnote for you.
If you are unsure about a new plugin, try it first in a safe copy of WordPress. Read our guide on how to use WordPress Playground to run a free test site in your browser.
How do you show footnotes as a list at the bottom of a post?
Turn on the list option in the plugin settings, or add the [mfn_list] shortcode where you want the list.
The built-in Footnotes block always shows its list at the bottom of the post. You type each note in that block, and readers click a number to jump down to it. That list is part of the block, so you do not need a setting to turn it on.
Modern Footnotes works differently. On desktop, a note appears as a tooltip when the reader clicks the number. On mobile, it expands as a section below the current text, according to its WordPress.org page (checked November 2026).
The list at the bottom is optional.
To add the list with Modern Footnotes, open Settings > Modern Footnotes and tick “Display footnote list at bottom of posts”, then save. Or place the shortcode [mfn_list] in the post where you want the list to appear. Both routes show the same notes.
Pick one display style per post. A tooltip plus a bottom list can repeat the same note twice on the page, which confuses readers. If your readers often print posts, use the bottom list, since tooltips do not print well.
How do you change how footnotes look?
Use the block settings for the built-in block, or the settings page and custom CSS for Modern Footnotes.
For the built-in Footnotes block, click the block at the bottom of the post and open its settings in the right sidebar. You can change the text color, typography, dimensions, and border from there. Keep the changes small, so the notes match the rest of your theme.
For Modern Footnotes, open Settings > Modern Footnotes and set how notes behave on desktop. You can show a note when the reader hovers over the number, when they click it, or expanded below the text. The same page lets you set the list heading, such as “Footnotes” or “References”, and pick its heading tag.
The plugin also lets you style single notes with the shortcode. The shortcode [mfn class='my-pretty-class'] adds your own class to one note, so you can style it alone, according to its WordPress.org page (checked November 2026). Use that only if you know CSS, and keep the class name short.
You can also set a fixed number for one note. The shortcode [mfn referencenumber=3] gives that note the number 3, according to the same page (checked November 2026). Use it only when a note must match a number in a quoted source.
How do footnotes work on phones?
On phones, built-in footnotes jump to the list at the bottom, while Modern Footnotes notes expand below the text.
The built-in block shows a numbered link in the text. A tap on it moves the reader to the note at the bottom of the post, and a link there takes them back. That works on any phone browser, since it is a plain jump link.
Modern Footnotes changes the behavior by screen size. On desktop, notes appear as a tooltip when the reader clicks the number. On mobile, notes expand as a section below the current text, according to its WordPress.org page (checked November 2026).
Readers do not lose their place in the post.
Test every footnote on a phone before you publish. Open the post on your own phone, tap each number, and check that the note opens and closes. A note that will not close, or one that covers the text, needs a settings change before the post goes live.
Keep note text short on mobile. A note of 1 or 2 sentences fits a phone screen well, while a long note pushes the post down and hides the text the reader was on.
When should you use footnotes instead of links?
Use footnotes for extra detail and sources, and use links when the reader should open another page.
A footnote holds a short note that helps the reader but is not the main point. A good use is a source for a claim, a definition of a term, or a date that adds context. The reader reads the note and stays on your post.
A link suits a page the reader should open next. Link to a related post, a source page, or a tool when the reader needs the full page. Read our guide on how to add internal links in WordPress to learn how to link between your own posts.
Do not use footnotes to hide key facts. If a fact matters to the point of the post, put it in the main text. A reader who never opens a footnote should still follow your argument.
Do not put links inside footnotes when a plain link in the text would do. A link in a tooltip is hard to tap on a phone, and a link at the bottom of the post is easy to miss. Keep links in the body text, where readers expect them.
How do you reset or renumber footnotes?
Let the built-in block renumber notes on its own, and use the referencereset option in Modern Footnotes when you need a fresh count.
The built-in Footnotes block removes and reorders footnotes as you edit, according to the Make WordPress Core post (checked November 2026). If you delete a note, the numbers after it shift down by 1. If you add a note at the top, every number after it shifts up by 1.
Modern Footnotes numbers notes in order too, but it also gives you manual control. The shortcode [mfn referencereset='true'] resets the counter, so the next note is numbered 1 again, according to its WordPress.org page (checked November 2026). Use it when a long post has separate sections that each need their own numbering.
You can also set a custom number with [mfn referencenumber=3], as noted above. That changes one note only, and the notes after it keep counting from the new number. Check the full list after you use it, since a manual number can clash with the automatic count.
Do not mix manual numbers and automatic numbers in one post unless you have a clear reason. A post where note 3 appears twice looks broken, even if the text is right.
How do you check that footnotes work?
Preview the post, click every footnote number, and confirm each note opens and shows the right text.
Start in the editor and read the list at the bottom of the post. Each note should appear once, with the right text, and the numbers should run 1, 2, 3 with no gaps. A gap means a note was deleted without its number, or a shortcode was left open.
Next, click Preview and test each number in order. Click a number, read the note, then go back to the text.
If a click does nothing, the shortcode may be missing its closing tag, such as a lost [/mfn]. If the wrong note opens, two notes may share a number.
Then check the post on a phone, as described above. Footnotes behave differently on small screens, so a desktop check is not enough. Also check the post in a second browser if you can, since some themes style footnotes in ways that clash with the plugin.
Footnotes work on both posts and pages in WordPress. If you are unsure which to use for a note, read our guide on posts vs pages in WordPress before you write the post.
What mistakes should you avoid?
Do not put long notes in footnotes, do not mix two footnote methods on one post, and do not leave a shortcode unclosed.
A footnote longer than 2 or 3 sentences belongs in the main text. Long notes hide key facts from readers who never open them, and they are hard to read on a phone. Move the fact into a paragraph instead.
Do not use the built-in block and Modern Footnotes on the same post. The two systems number notes on their own, so you can end up with two notes numbered 1 on one page. Pick one method per post and stick to it.
Do not leave a shortcode open. A missing [/mfn] can swallow the rest of the paragraph into a footnote, or break the list at the bottom. Preview the post after every edit that touches a shortcode.
Do not add footnotes to old posts without checking them. A footnote added to a live post needs the same preview and phone check as a new one. Read our guide on how to update old posts for SEO to plan the order, and start with your most visited posts.
Frequently asked questions
Can I add footnotes in WordPress without a plugin?
Yes, if you use the built-in Footnotes block. It arrived in Gutenberg 16.1 and shipped with WordPress 6.3, so any site on a current WordPress version has it. Highlight a word, pick Footnote in the block toolbar, and type the note at the bottom of the post.
What is the difference between tooltip footnotes and a footnote list?
A tooltip appears when the reader clicks or hovers over the number, while a bottom list shows every note at the end of the post. Modern Footnotes can do both, but pick one style per post so the same note does not appear twice on the page.
Why did my footnote text vanish from the post?
Check for a missing closing tag. A shortcode needs both [mfn] and [/mfn], and a lost closing tag can swallow the rest of the paragraph or break the list. Preview the post after every edit that touches a shortcode and fix any open tag.
Can I set a custom number for a footnote?
Yes, in a limited way. The shortcode [mfn referencenumber=3] gives one note the number 3, and [mfn referencereset='true'] restarts the count at 1. Check the full list after you use either option, since a manual number can clash with the automatic count.
How long should a footnote be?
Keep each note to one or two sentences. A note of that length fits a phone screen and does not push the post down. If a note needs more than two or three sentences, move the fact into a paragraph in the main text instead.
Can I use the built-in Footnotes block and Modern Footnotes together?
No. Pick one method per post. The built-in block and Modern Footnotes each number notes on their own, so using both can put two notes numbered 1 on one page. Choose the block for simple notes and the plugin when you want tooltips and more style control.
Sources
- Modern Footnotes WordPress.org
- What's new in Gutenberg 16.1? Make WordPress Core
- What's new for developers? (July 2023) WordPress Developer Resources
- Modern Footnotes repository GitHub
Is your product missing, or something out of date?
Tell us what to add or correct. We read every note and reply when we need a source. A message does not buy a ranking.
Thanks — we review requests within 3 business days.


