How to Handle Hyperlinks in Your Ebook (And Which Ones Break on Kindle)

Hyperlinks in ebooks fall into three categories: internal links (table of contents, cross-references, footnotes), external links (URLs to websites), and mailto links. All three work reliably in reflowable EPUB files, but Kindle’s conversion process strips or breaks specific link types depending on the format, the device, and Amazon’s content policies.

Which Types of Hyperlinks in Ebooks Actually Work?

Reflowable EPUB files support three distinct link types, each with different behaviour across reading platforms. Understanding the distinctions matters because a link that works perfectly in your EPUB source file may vanish or malfunction after a retailer processes it.

Internal links connect one part of the ebook to another: table of contents entries, chapter cross-references, and footnote or endnote markers. The W3C EPUB3 specification defines these as standard HTML anchor elements using fragment identifiers (e.g., <a href="#chapter-3">). Internal links are universally supported across every major reading platform because they never leave the book file. Footnote links specifically must be bidirectional: readers need both a forward link from the superscript number to the note text and a return link back to their reading position. If you are working with footnotes and endnotes, the formatting rules for making them work across both print and ebook are covered in detail in our guide to formatting footnotes and endnotes that work in both print and ebook.

External links point to websites outside the book (e.g., <a href="https://example.com">). These are allowed in reflowable Kindle ebooks, Apple Books, Kobo, and Google Play Books. However, each platform handles them differently: some open the link immediately, others display a confirmation dialog, and Amazon prohibits certain destination URLs entirely. External links are not supported at all in fixed-layout ebooks on KDP.

Mailto links (e.g., <a href="mailto:author@example.com">) are the most fragile type. They depend on the reading device having an email client available. On dedicated Kindle e-ink hardware, mailto links do nothing because the device has no email application. On Kindle apps for iOS and Android, they may hand off to the device’s default mail app, but behaviour is inconsistent.

Why Do Links Break After KDP Conversion?

KDP’s ingestion pipeline converts your uploaded file into Amazon’s internal format, and this conversion process is where most link failures occur. The specific failure mode depends on what you uploaded and what type of link broke.

.docx uploads lose bookmark-based links. Microsoft Word uses bookmarks for internal cross-references. When KDP converts a .docx file directly, it attempts to map Word’s bookmark system to Kindle’s internal link structure. The results are inconsistent: some bookmarks convert cleanly, others lose their targets entirely. The table of contents links generated by Word’s built-in TOC feature generally survive, but manually created bookmark links (the kind you would use for cross-references like “see Chapter 7”) frequently break. According to KDP’s hyperlink guidelines, links in uploaded manuscripts must use standard HTML anchor elements; Word’s proprietary bookmark format is not guaranteed to convert.

EPUB uploads with non-standard anchors fail silently. If your EPUB uses anchor IDs that contain special characters, spaces, or begin with numbers, KDP’s parser may strip them during conversion. Valid EPUB3 anchor IDs should start with a letter and contain only letters, numbers, hyphens, and underscores (e.g., id="chapter-3" rather than id="3-chapter").

Fixed-layout ebooks strip all external links. This is by design, not a bug. KDP does not support outbound hyperlinks in fixed-layout files (children’s books, comics, cookbooks, and heavily designed non-fiction). If your book relies on external links for supplementary content, you must use reflowable format or accept that those links will not function on Kindle.

Prohibited links trigger rejection. Amazon blocks links to competing ebook retailers (Apple Books, Kobo, Barnes & Noble), links that direct readers to purchase content outside the Kindle Store, and links to applications or services that compete with Amazon’s offerings. A manuscript containing a link to your book on another retailer’s site may be rejected during review or have the link silently removed.

How Do Hyperlink Rules Differ Across Kindle, Apple Books, and Kobo?

Each major ebook platform handles hyperlinks according to its own policies and technical constraints. The table below summarises the key differences for reflowable EPUBs.

Apple Books deserves special attention because it actively warns readers before opening any external link. A dialog box appears asking whether the reader wants to leave the book. This is not a bug; Apple treats it as a safety feature. The practical consequence is that external links in Apple Books carry friction that may discourage readers from clicking, so links to genuinely useful resources (your author website, a reference source) are worth keeping, but decorative or low-value links create a poor experience. Apple also flags Amazon links specifically, making cross-promotion between platforms impractical. For a broader look at why the same EPUB can behave differently across platforms, see our post on why your EPUB passes Kindle but fails on Apple Books or Google Play.

Kobo supports hyperlinks with fewer restrictions than either Amazon or Apple. Links open in the device’s built-in browser, and Kobo does not block links to competing retailers. On older Kobo e-ink models, footnote links behave as standard linked endnotes rather than pop-ups; newer firmware versions support the EPUB3 pop-up overlay pattern.

How Do You Add Hyperlinks in Vellum, Atticus, and Word?

The method for inserting hyperlinks depends on your formatting tool, and each tool handles the conversion to EPUB differently. Getting the links right at the source file stage prevents most of the breakage described above.

Vellum (Mac; $249.99 for print + ebook)

Vellum provides dedicated features for both link types. For external web links: select the text you want to link, open the Text Feature menu, and choose Web Link. Paste the full URL including https://. Vellum’s Smart Links feature automatically detects bare URLs in your text and converts them to tappable hyperlinks. For internal links: select the text, choose Internal Link, and pick the target chapter from the dropdown. Vellum generates clean EPUB3 anchor markup and automatically strips all hyperlinks from the print edition, so you do not need to maintain separate files. If you are producing both print and ebook from a single source, the workflow is covered in our guide to producing both a paperback and ebook from one Word file.

Atticus (Mac, Windows, Linux, Chromebook; $147 one-time)

Highlight the text you want to link, click the Link button in the toolbar, and enter the URL with the https:// prefix. Atticus supports internal chapter links through its chapter navigation system. The tool generates reflowable EPUB output with standard HTML anchor elements. Atticus does not currently offer a Smart Links feature equivalent to Vellum’s automatic URL detection.

Microsoft Word

Select text, then use Insert → Link (or Ctrl+K / Cmd+K). For external URLs, paste the address in the URL field. For internal cross-references, use Insert → Bookmark to create a named target, then link to it using the “Place in This Document” option. The critical caveat: Word’s bookmark-based links are the ones most likely to break during KDP’s conversion. If you are uploading a .docx directly to KDP, test every internal link in Kindle Previewer after conversion. If links break, consider converting the .docx to EPUB using Calibre or Sigil first, then uploading the EPUB to KDP instead.

How Should You Test Ebook Links Before Publishing?

Testing links after formatting and before uploading to any retailer catches broken anchors, stripped URLs, and non-functional mailto links before readers encounter them.

Kindle Previewer 3 (free, available from KDP) simulates exactly how your file will render on Kindle devices and apps. Open your .epub or .docx file in Kindle Previewer, navigate to the table of contents, and tap every link. Check that each TOC entry jumps to the correct chapter, that footnote links open as pop-ups and return correctly, and that any external links display as tappable blue text. Kindle Previewer runs the same conversion pipeline that KDP uses, so a link that works here will work on real Kindle hardware.

EpubCheck (free, open-source from the W3C) validates your EPUB against the specification and reports errors including broken internal links, missing anchor targets, and malformed URLs. Run it on your EPUB file before uploading to any retailer. EpubCheck does not test whether links function on specific devices; it verifies that the underlying markup is correct.

Side-loading to a real device remains the most reliable test. Send the EPUB to your Kindle via email (using your Send-to-Kindle address), load it on an iPad in Apple Books, and open it in the Kobo app. Test every link type on every platform you plan to distribute through. Five minutes of testing catches problems that no automated tool can detect, particularly mailto link behaviour and platform-specific confirmation dialogs.

How Can You Prevent Link Rot in Your Ebook?

An ebook with external links has a shelf life problem: the web pages those links point to may move, change, or disappear. Unlike a website, you cannot update a published ebook’s links without uploading a new version to every retailer.

Use stable, institutional URLs. Link to official documentation pages (KDP Help, W3C specifications, university press sites) rather than blog posts or news articles. Institutional pages are maintained and redirected when they move; blog posts frequently vanish. Government and standards-body URLs (e.g., Library of Congress, BISG) are among the most stable links on the web.

Archive critical links. Before publishing, save copies of the pages you link to using the Internet Archive’s Wayback Machine. If the original page disappears, the archived version remains accessible. For academic or research-heavy ebooks, Perma.cc (operated by the Harvard Law Library) creates permanent archived links specifically designed for citation purposes.

Minimise the number of external links. Every external link is a future maintenance liability. Include only links that genuinely add value for the reader: official specifications, primary sources, and tools the reader will need. Skip links to supplementary reading, social media profiles, and promotional pages. If a link is not essential enough that you would update your ebook file when it breaks, it is not essential enough to include.

Use your own domain as a redirect layer. Instead of linking directly to a third-party page, create a redirect on your author website (e.g., yoursite.com/resources/style-guide) that points to the current destination. When the target page moves, update the redirect on your website rather than republishing the ebook. This approach works for any link you expect to be long-lived and important.

Handling hyperlinks in ebooks comes down to knowing which link types each platform supports, formatting them correctly in your authoring tool, and testing before you upload. Start with clean EPUB3 anchor markup, avoid mailto links unless you accept the Kindle e-ink limitation, check KDP’s prohibited link list, and run every link through Kindle Previewer 3 and at least one other platform’s reader. A few minutes of pre-publication testing prevents broken links from reaching your readers.

Frequently Asked Questions

Do external links work on Kindle e-readers?

Yes, external links work in reflowable Kindle ebooks on both e-ink devices and Kindle apps. Tapping an external link opens the Kindle device’s built-in experimental browser (on e-ink) or the device’s default browser (on tablets and phones). However, external links are not supported in fixed-layout Kindle ebooks and are stripped during conversion.

Can I link to my other books on Amazon from inside my ebook?

Yes. Links to other products on Amazon, including your own books, are allowed and common. Many authors include an “Also By” page with links to their other titles on the Kindle Store. What Amazon prohibits are links to competing retailers (Apple Books, Kobo, Barnes & Noble) and links that direct readers to purchase content outside Amazon’s ecosystem.

Why does my table of contents work in Calibre but not on Kindle?

Calibre and Kindle use different methods to read internal links. Calibre is an EPUB reader that follows standard HTML anchor elements directly. KDP’s conversion process rebuilds the internal link structure, and non-standard anchor IDs (those containing spaces, special characters, or starting with numbers) may be stripped or remapped incorrectly. Regenerate your TOC with clean anchor IDs and test in Kindle Previewer 3 before uploading.

Should I include my email address as a mailto link in my ebook?

A mailto link is a reasonable way to let readers contact you, but be aware of the limitations. The link will not function on Kindle e-ink devices because they lack an email client. On Kindle apps and Apple Books, it will open the device’s email app. Consider including your email as plain text alongside the mailto link so readers on e-ink devices can still copy and use it manually.

How do I update links in an already-published ebook?

Upload a new version of your ebook file to each retailer where it is published. On KDP, go to your Bookshelf, click the ellipsis menu next to the title, choose “Edit eBook Content,” and upload the corrected file. Amazon will push the update to readers who have already purchased the book, though the timing varies. On other platforms (Draft2Digital, Kobo Writing Life, Apple Books Connect), the process is similar: replace the file and republish.