← toolkit.bot

EPUB Footnotes and Endnotes: Popup Notes, Asides, and Best Practices

June 12, 2026  ·  7 min read

Footnotes in e-books work differently from print. Good EPUB footnotes use popup notes that appear inline without navigating away from the text — a much better reading experience. Here's how to implement footnotes correctly for EPUB 3.

Three Footnote Approaches

ApproachEPUB versionReader supportReading experience
Linked footnotes (same file)EPUB 2 + 3UniversalNavigates to note, back button returns
Linked footnotes (separate file)EPUB 2 + 3UniversalNavigates to notes chapter
Popup notes (epub:type="footnote")EPUB 3 onlyModern readersInline popup, no navigation

EPUB 3 Popup Footnotes (Recommended)

EPUB 3 popup notes use epub:type="noteref" on the reference and epub:type="footnote" or epub:type="endnote" on the note content. Supporting readers (Apple Books, Thorium Reader, Kindle for iOS/Android) display these as popups.

<!-- In the chapter text -->
<p>
  The author argues this point at length.<a
    epub:type="noteref"
    href="#fn1"
    id="fn1-ref"
    role="doc-noteref"><sup>1</sup></a>
</p>

<!-- Note definition — can be in same file or a separate notes file -->
<aside
  epub:type="footnote"
  id="fn1"
  role="doc-footnote">
  <p><sup>1</sup> Smith, J. (2024). <em>The Complete Argument</em>, p. 42.</p>
</aside>

Footnotes in a Separate File

For books with many notes, keeping them in a separate notes.xhtml file is cleaner:

<!-- In chapter01.xhtml -->
<a epub:type="noteref" href="../notes.xhtml#fn1" role="doc-noteref"><sup>1</sup></a>

<!-- In notes.xhtml -->
<aside epub:type="footnote" id="fn1" role="doc-footnote">
  <p><sup>1</sup> Full citation here.</p>
</aside>

Include the notes file in the OPF spine with linear="no" so it doesn't appear as a chapter:

<itemref idref="notes" linear="no"/>

Endnotes vs Footnotes

In EPUB terminology:

In practice, use footnote for popup-style notes and endnote when notes are collected at the back. The popup behavior depends on the reading system, not just the epub:type value.

Accessibility for Notes

Use ARIA roles alongside epub:type for maximum accessibility:

<a epub:type="noteref" href="#fn1" role="doc-noteref"
   aria-label="Footnote 1"><sup>1</sup></a>

<aside epub:type="footnote" id="fn1" role="doc-footnote"
       aria-label="Footnote 1">
  <p>Note content here.</p>
</aside>

Screen readers use role="doc-noteref" and role="doc-footnote" (from the DPUB-ARIA vocabulary) to announce note references and allow quick navigation between notes.

Footnotes from PDF Conversion

PDFs with footnotes store the note text at the bottom of the page. When converting with toolkit.bot, footnote text is detected and linked back to the reference point using EPUB 3 popup note markup. The reading flow stays intact — notes don't interrupt the main text.

Convert PDF with footnotes to EPUB →