Skip to content

MkDocs use_directory_urls: true bug with click==8.2.2 #4014

@glenn-jocher

Description

@glenn-jocher

Context

Latest version of click dependency (released August 2, 2025) is breaking use_directory_urls: true functionality in MkDocs and MkDocs Material.

Bug description

This is causing 404's when clicking on links to previously published pages.

Example Good with click==8.2.1
https://docs-paasvkc6c-ultralytics.vercel.app/models/yolo11/

Example Bad with click==8.2.2
https://docs-paasvkc6c-ultralytics.vercel.app/models/yolo11/index.html

Related links

ultralytics/ultralytics#21568

Reproduction

Reproduce with steps above.

Steps to reproduce

Set use_directory_urls: true in mkdocs.yml with click==8.2.2 installed in environment, then run mkdocs serve.

Browser

Chrome

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions