Skip to content

Sidebar no longer scrolls on hover in published docs #3571

@AgentTono

Description

@AgentTono

Bug description

Since ~Aug 14–15, 2025, the left sidebar in published GitBook docs no longer scrolls when you hover it and use the mouse wheel / trackpad. Instead, the main page scrolls. This reproduces on GitBook’s own site (such as here: https://gitbook.com/docs/getting-started/git-sync/troubleshooting), suggesting a platform regression tied to the recent “new sidebar” changes (https://www.gitbook.com/blog/new-sidebar).

How to reproduce

  1. Create a page in GitBook with >20 Heading blocks (I used "Heading 2", not sure that matters)
  2. Under any of the headers, add 20 new lines (this makes it so the main content is scrollable)
  3. Publish the page
  4. View the published page
  5. Hover over the table of contents in the sidebar and try to scroll
  6. Observe that the sidebar does not scroll
  7. Scroll to the bottom of the main content
  8. Observe that the sidebar is cut off after the ~18th header and there is no way to see it
  9. Zoom out in the browser window
  10. Observe that the additional Headings are now shown in the sidebar

Additional context

Where a page has many more headings (>40) the user must zoom out tremendously to even see the headings at the end of the list in the sidebar so much so that the main text (and the sidebar) is completely unreadable. Restricting the ability to scroll in the sidebar as before effectively limits the number of headings that can be used on a GitBook page. This limitation is very impactful for pages that contain a lot of information, such as a technical reference page.

Image

Metadata

Metadata

Assignees

No one assigned

    Labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions