1. Document Library Pro
  2. Document Library Options

Document folders

The folders option in Document Library Pro controls the overall structure of your document libraries.

Folders disabled

This is the default option and lists all your documents in a single table, regardless of their category. You can disable folders on the plugin settings page, or by adding folders="false" to the shortcode, for example: [doc_library folders="false"]

Folders enabled

This structures your document library into a hierarchical folder tree structure listing the document categories, sub-categories, and so on.

When the user clicks on a folder, they will see a table listing the documents from that category and/or folders for the sub-categories. The user can then click on a sub-category to view a table of documents in the sub-category, and so on.

The folders are collapsible and only one folder will ever be open at a time. This helps to make the document library easy to navigate, so that the user never gets lost.

You can enable folders on the plugin settings page, or by adding folders="true" to the shortcode, for example: [doc_library folders="true"]


Does it support sub-categories?

Yes, sub-categories will be indented to show the folder structure. You can have as many levels of categories as you like, and the child categories will always be nested under their parent category. Of course, this assumes that the page is wide enough to accommodate deep category structures with many levels!

If a category has documents AND sub-categories, then it will show like this:

  • Category 1
    • Table listing documents that are in category 1 but not any of its sub-categories
    • Category 1a name and folder icon
      • Table listing documents in category 1a

How are the categories ordered?

The folders are listed in the same order they appear under Documents → Categories in the WordPress admin. You can change the order by restructuring the categories, for example with the WP Term Order or Custom Taxonomy Order plugins.

Can a document appear in multiple folders?

Yes, if a document is in multiple categories then it will appear in multiple tables, under each of its categories. The exception is if it is in a parent category and its child category, in which case it will only appear in the table for the child category.

Can I exclude specific categories from the folders list?

Yes, please see our article about how to edit the shortcode to control which documents to include and exclude. This includes options on excluding specific categories or sub-categories.

Related Articles

Still need help?
If searching the knowledge base hasn't answered your question, please contact support.