# Footnote

Drops a small numbered marker like \[3\] into a sentence, with the note's text on hover, and feeds that note into the page's Footnotes summary.

Use this when a sentence needs a source, a caveat or an aside that would break the flow if you wrote it inline. You put the marker where the sentence is, and the actual wording lives in the footnote instead of cluttering the paragraph. The marker numbers itself from its position on the page, so you can add, delete or reorder footnotes and every number renumbers itself the next time the page is saved. Pair it with the Footnotes summary macro at the bottom of the page to get the collected list of notes; on its own the marker is still readable, because the text shows in a tooltip when a reader hovers it.

---

## See it

Every example below is a real macro on this page, not a screenshot, and each one is a configuration taken from a page somebody actually built. Open this page in the editor to see how any of them is set up.

### Demo quotation included for illustrative purposes

A footnote marker sits in the text like this[\[1\]](#fn-1), and collects at the foot of the page.

### A footnote usually contains supporting information

A footnote marker sits in the text like this[\[2\]](#fn-2), and collects at the foot of the page.

### For example, a term could be briefly defined here in

A footnote marker sits in the text like this[\[3\]](#fn-3), and collects at the foot of the page.

---

1. Demo quotation included for illustrative purposes. Replace with a real source when using this pattern in production. [↩](#fn-ref-1)
2. A footnote usually contains supporting information that is useful but not essential to the main sentence. [↩](#fn-ref-2)
3. For example, a term could be briefly defined here instead of adding a long aside in the paragraph. [↩](#fn-ref-3)

---

## Settings

![The Footnote macro's insert window. The preview on the left shows a small bracketed asterisk marker. The configuration panel on the right has a Footnote Text box containing the word test, described as](https://help.gocapable.com/images/871ce42b-f89c-4852-acf3-61b97ce05e2b.webp)

The note's text goes in the panel on the right, alongside an optional stable id for cross-references.

| **Setting**             | **Values**                                                                                                                              | **What it changes**                                                                                                                                                                                                                     |
| ----------------------- | --------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Footnote Text           | Free text, multi-line (the JSON-Forms control sets \`options: { multi: true }\`). No maximum length is enforced anywhere in the schema. | This is the note itself. It is what appears in the Footnotes summary list, and what a reader sees in the tooltip when they hover the marker. If you leave it empty the footnote is invisible to the numbering: the marker renders as \[ |
| Reference Id (optional) | Free text. The config form suggests a slug such as \`note-1\`.                                                                          | Almost nothing a user can observe. It is only used as a fallback way for the marker to recognise itself when the internal instance id does not match - i.e. it can break a tie between two footnotes that would otherwise be indisting  |

---

## Related

[Footnotes summaryPrints the numbered list of every footnote on the page, in the order the markers appear.](https://help.gocapable.com/macros/footnotes-summary.html)

[FootnotesThe rest of this family.](https://help.gocapable.com/macros/footnotes.html)

---

_Numbered in place, collected at the foot._