Folders or grouping pages in GitHub Wikis

[ghost]

Hi!

I was working on translating the documentation of a project and I stumble in a problem. How to organize documentation of diferent languages in a wiki? Is there a way to group pages in folders or in collapsable groups?

As far as I see, all the pages get placed in the same “level”.

Any ideas? thanks in avance.

Dknacht

[ghost]

Hi @dknacht,

While there currently isn’t a way to group pages by folder or in collapsible groups, you could set up a custom sidebar to achieve a similar effect which would allow you to link to each Wiki page in categorised lists. It might also be worth contacting GitHub Support to note this as a feature request.

Would something like that work for you? ​If there’s anything else I can help you with, let me know; so happy to help further!

Kindest regards,
Matthew

[tormung83]

The answer is simple: GitHub does not support this feature and it won't support it anytime soon. I got a response from Support stating this is not in their roadmap.
I will cancel my Pro subscription for now but continue using the free version and move my project to GitBook as it offers what GitHub can't right now.
Then I will just integrate it with GitHub. Here are some tutorials that convinced me to move to GitBook.
(18) GitBook - Getting started - YouTube
(18) GitBook - GitHub integration - YouTube

[pythoninthegrass]

Good find @tormung83. Seems like such a basic feature and disappointing that we have to resort to third-party sites to implement it.

[dirk-bester]

Does GitHub Pages not support this? The internal one is quick and dirty. pages has internationalization and Jekyll support etc.

[ghost]

Hi! @matthewheath
Thanks so much for your answer.
I will check the custom sidebars, it looks like they are going to do the job.
In this page the image shows pages listed in embedded lists. Do you know how to make this?

Thanks so much again and best regards.
Dknacht.

[ghost]

Hello @dknacht,

Sure — they’re just HTML code using list elements.

The actual code would look something like

<ul>
  <li>Top level page
    <ul>
      <li>Sub-page</li>
      <li>Sub-page two</li>
    </ul>
</li>
</ul>

That would then give you a nested list like the image shows.

[ghost]

Great!,

That’s what I needed.

I am going to conact github support tho so see if they can implement something.

Thanks man!

Have a good day!.

Dknacht

[berto]

Please implement this! 

I’m sendin a message to support as well.

[ThirdEyeRose]

Hi @dknacht and @tallberto,

Thanks for this feedback! We’re always working to improve GitHub and the GitHub Community Forum, and we consider every suggestion we receive. I’ve logged your feature request in our internal feature request list. Though I can’t guarantee anything or share a timeline for this, I can tell you that it’s been shared with the appropriate teams for consideration.

Please let me know if you have any other questions.

Thanks!

[tormung83]

Hello, @ThirdEyeRose did this feature ever made it to the discussion table? I personally need to work on a Wiki project and a Side bar is not really what I'm really looking for. I need to place notes (pages) inside folders or collapsable pages.

[ThirdEyeRose]

Unfortunately, I do not know. I left GitHub a few years ago. During that time, I had very little insight into the product roadmap as a support person.

[rusioana]

Hi, where exactly do you add the HTML formating for the list? In the first page of the section which you want to create?

[ghost]

I’m trying to do this too and I cannot get it to work, I’ve googled it extensively and found a couple of links, specifically https://github.com/tajmone/github-tests/wiki/subpage, https://stackoverflow.com/questions/11088285/github-wiki-directories and https://github.com/KirstieJane/STEMMRoleModels/wiki/Creating-new-folders-in-GitHub-repository-via-the-browser

When I try it, I don’t get anything like a subfolder, just a new file with the path as it’s name and the forward slashes replaced with space, like this

subfolder subpage.md

When I try creating the sub sidebar it just overwrites the original sidebar and the Create Custom Sidebar dissapears, which is not what I want.

I know this can be done because I’ve seen several github wikis which do this. But I don’t know exactly how. Please help, going slightly nuts here

[demisx]

Please implement this feature. GitLab Wiki does this and it’s really useful

[bisdevres]

please implement this.

i also contacted support for this

[demisx]

We need this feature desperately. Maintaining Wiki with more than a few pages is very impractical under current functionality. Thank you. 🙏🏻

[abalter]

Adding my support.

[TonyWhiteSMS]

Having to replace a Confluence site with GitHub wiki as business won't pay for enough licences to make Confluence accessible by those that need it. Folders and grouping really are needed

[jakurll]

PLEASE add this :)

[knassre-cmu]

Pretty please add this feature :)

[JonathanDHolden]

I've just paid for GitHub wiki, only to discover that it's unusable as there are no folders.

Looks like it's time for a chargeback.

[gabezurita]

The need for Github WIki folders has been a request for at least 12 years:
https://stackoverflow.com/questions/11088285/github-wiki-directories

Here is some additional history:
https://github.com/orgs/community/discussions/14020

[HabibaGadalla]

still no proper wikis structure ):

[clombardi]

I'm so surprised that GitHub Wiki lacks some basic features so it becomes impossible to properly organize the contents. Currently I'm locked on for corporative reasons, but the outcome I can produce is quite sad to see.

[singhsoldier13]

+1

[MackHalliday]

why isn't this supported? Such a simple feature.

[ccgargantua]

because microsoft hates their users and only delivers to shareholders

[nurbek-mirai]

Bump.

[edgar-kautzner]

Please develop this feature - this is really needed!!

[pmatulis]

I am veritably gobsmacked that you cannot use the Wiki feature as... a wiki.

[dazzknowles]

+1 Here too, this is basic functionality that is sorely lacking.

[smith-sj]

I just started using GitHub's Wiki feature and am disappointed such a basic functionality is missing. Adding this to the list of things Azure DevOps (surprisingly) does much better.

[thomaswitt]

+1 - wikis with subdirectories would be a great feature. This way one could integrate docs like PRDs for a project as git submodule and have a comfortable way to view and edit them.

[kkamegawa]

I’m in favor of improving the Wiki. While coding agents can generate documentation, I see two different types of content: documentation that should live inside a repository and documentation that should live alongside it. For things like operational guides, FAQs, and design documents, I would prefer to keep them in the Wiki.

I find the Azure DevOps Wiki much more convenient than GitHub’s. It provides APIs and CLI support, links continue to work even after pages are moved, it supports a page hierarchy, and it can dynamically render work items. I’m quite happy with it overall. The fact that it doesn’t require any initialization is another big advantage. 🙂