• 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
  • Set up a new project
  • How-to guides
    • Configure your project
    • Build and preview
    • Publish on Read the Docs
    • Enable Google Analytics
    • Update your starter pack
      • New starter pack
      • Legacy starter pack
    • Test the Ulwazi theme
    • Troubleshooting
    • Optional customisation
      • Bridge project and docs builds
      • Customise PDF output
      • Use Spread to test commands in documentation
      • Use custom HTML templates
      • Add Mermaid diagrams
      • Add Python docstrings
      • Add OpenAPI specifications
      • Add interactive tables
  • Reference
    • Automatic checks
      • Accessibility check
      • Inclusive language check
      • Link check
      • Lint check
      • Check for removed URLs
      • Spelling check
      • Style guide linting
    • Default Sphinx extensions
    • reStructuredText syntax
    • MyST syntax
  • Explanation
    • Starter pack structure
    • Build
    • Sitemaps
  • Release notes
    • 1.6
    • 1.5
    • 1.4
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.

© 2026 Canonical Ltd.
This page is licensed under CC-BY-SA-3.0
Last updated on Dec 02, 2025
Contents
  • Link check
    • Run the link check
    • Configure the link check