• Logo
    Documentation starter pack
  • documentation.ubuntu.com
  • More resources
    • Discourse
    • Mattermost
    • Matrix
    • GitHub
Contents Menu Expand Light mode Dark mode Auto light/dark, in light mode Auto light/dark, in dark mode Skip to content
Documentation starter pack documentation
Documentation starter pack documentation
  • Tutorials
    • Set up the documentation repository
    • Set up automated testing for a Sphinx-based tutorial
  • How-to guides
    • Set up Read the Docs
    • Customise the setup
    • Customise PDF output
    • Migrate from the pre-extension starter pack
    • Update the documentation
      • Install prerequisites
      • Build and preview
      • Edit content
      • Get guidance
    • How to contribute
  • Reference
    • Automatic checks
      • Accessibility check
      • Inclusive language check
      • Link check
      • Spelling check
      • Style guide linting
    • ReStructuredText cheat sheet
    • Markdown/MyST cheat sheet
    • reStructuredText style guide
    • MyST style guide
Back to top

Link check¶

The link check uses Sphinx to access the links in the documentation output and validate whether they are working.

Run the link check¶

Run the following command from within your documentation folder.

Validate links within the documentation:

make linkcheck

Configure the link check¶

If you have links in the documentation that you don’t want to be checked (for example, because they are local links or give random errors even though they work), you can add them to the linkcheck_ignore variable in the conf.py file.

Copyright © 2025 CC-BY-SA, Canonical Ltd.
Last updated on Mar 28, 2025
Contents
  • Link check
    • Run the link check
    • Configure the link check