Skip to content
EPUBCheck · Navigation document

EPUBCheck NAV-010: nav links to a website

Updated:

EPUBCheck NAV-010 is an error message: “"…" nav must not link to remote resources; found link to "…".” A table of contents, page list or landmarks entry links to a remote resource. Links in these three navs must point to a document inside the EPUB, and EPUBCheck names the nav type and the URL it found.

The official message

"%1$s" nav must not link to remote resources; found link to "%2$s".

Default severity
Error. The EPUB breaks a rule of the specification and is invalid. Stores and Send to Kindle may reject it, and EPUBCheck exits with status 1.
EPUBCheck version
5.4.0

%1$s, %2$s… are filled in with the file, value or element EPUBCheck found.

Typical causes

  • A table of contents entry that links to a website, such as the publisher's page.
  • A landmarks entry pointing to an online version of the cover or the index.

How to fix it

  1. Point the entry to a document in the EPUB, or a fragment in it.
  2. Move the web link into the content, for example on a copyright or about page, and link that page from the table of contents if needed.
  3. Other nav types (a custom list) may link outside the EPUB; only toc, page-list and landmarks may not.
  4. Rebuild the EPUB and run EPUBCheck again to confirm the message is gone.

When it's not this

If the link points inside the EPUB but to a file that is missing, that is RSC-007.

Terms used here

Other NAV messages

  • NAV-011 "…" nav must be in reading order; link target "…" is before the previous link’s target in … order.
  • NAV-006 Content documents contain "figure" elements but the Navigation Document does not have a listing of figures (epub:type="loi").
  • NAV-003 The Navigation Document must have a page list when content document(s) contain page breaks (epub:type="pagebreak").
  • NAV-001 The nav file is not supported for EPUB v2.

Sources

Message text and severity from EPUBCheck 5.4.0 (W3C, BSD-3-Clause). Explanation by EpubCC.

FAQ

What does EPUBCheck NAV-010 mean?

EPUBCheck NAV-010 is an error message: “"…" nav must not link to remote resources; found link to "…".” A table of contents, page list or landmarks entry links to a remote resource. Links in these three navs must point to a document inside the EPUB, and EPUBCheck names the nav type and the URL it found.

Is NAV-010 an error?

NAV-010 is reported as error by default. The EPUB breaks a rule of the specification and is invalid. Stores and Send to Kindle may reject it, and EPUBCheck exits with status 1.