In this article, we'll cover the four Category Types available in your Higher Logic Vanilla (Vanilla) community:
- Discussions
- Nested
- Flat
- Heading
Before we begin...
Because Category Types are an integral aspect of Categories, here's a quick refresher:
- Categories are the high-level organizers of your posts.
- Each post must be placed in a Category.
- Each Category must be assigned a Category Type, which determines its behavior and purpose.
📝 NOTE: Check out the article below for more information about Categories, including how to configure and manage them.
You can view your community's Categories by clicking Categories in the top navigation available on all community pages.
Category Types
Category Types allow admins to create a streamlined and easy-to-navigate Category hierarchy for your users, and you'll likely make use of each type to do so. With this in mind, let's learn about each one, so you understand their purpose.
Discussions
📝 NOTE: While this Category is called "Discussions," it's purpose is to host all default Post Types (discussions, questions, ideas, polls, along with any custom Post Types).
Discussions Categories are important because:
- They're the only Category Type that can contain posts (hence its name).
- When creating a post, these Categories will be the only ones selectable when choosing where to post it.
📝 NOTE: A Discussion Category can have subcategories. If a subcategory is also set to the Discussions type, users will be able to contribute posts in both the "parent" Category and the "child" subcategory. While there may be certain use-cases where this is desired, it can also lead to confusion for your users, who may post their posts in the wrong Category. Generally speaking, you'll want to use the Nested, Flat, or Heading types as parent Categories.
Nested
Nested Categories function as a "container" in which to add other Categories.
- They cannot directly host posts.
- They function as a clickable title to "drill down" to additional Categories and content.
- They are not automatically sorted alphabetically, but you can drag and drop them via their hamburger icons to manually arrange them.
As shown below, Nested Categories can be several levels deep, and are ideal for creating a branching structure, typically to host different (but related) posts.
✔️ TIP: Nested Categories will not display on your front end Categories page until you have nested other Categories within them (e.g., a Discussion Category). To nest a Category within a Nested Category, drag and drop it underneath, and to the right, until you see the visual indentation occur.
📝 NOTE: If your Vanilla community is leveraging our Subcommunities feature, top-level Categories must be set to Nested.
Restricted Content in Nested Categories
There is a caveat that you should be aware of if your community has a Nested Category that has multiple subcategories — each of which has its own permissions set — and custom layouts with the Last Post feature.
There may be instances when the last post is from a subcategory that a user does not have permission to view. In this case, a "Restricted Content" placeholder displays in the Last Post section.
To better understand this situation, review the following example.
⭐️ EXAMPLE: Assume the following Nested Category > Subcategories scenario:
Nested Category: Dogs (permission: visible to all)
- Subcategory 1: German Shepherds (permission: visible to all)
- Subcategory 2: Border Collies (permission: visible only to users with a specific Role)
In the Dogs Nested Category, the custom layout is configured to display the "Last Post" section, in which would be listed the last post or comment from that Nested Category’s subcategories.
Using the example above, I view the Nested Category:
- If the last post was in German Shepherds, that last post will display for me.
- If the last post was in Border Collies, which has visibility limitations:
- if I have the specific Role permission for the Border Collies subcategory, that last post will display for me.
- if I do not have the specific Role permission for the Border Collies subcategory, that last post will not display for me. Instead, the "Restricted Content" placeholder will display.
Workarounds
You can avoid this situation in either of two ways.
- Do not “nest” any Categories that have content that you want “permissions-gated.”
- Do not apply permissions-based restrictions on Nested Categories; remove any current permissions-based restrictions on Nested Categories.
Flat
Similar to Nested, Flat Categories function as a "container" for other Categories and cannot directly host posts. However, there are a few notable differences that set them apart:
- Flat Categories can only be one level deep.
- They are automatically organized alphabetically.
- They cannot be manually organized (notice the lack of hamburger icons on the left).
- Nested Categories offer a paginated directory structure that can handle thousands of subcategories (notice the previous/next page buttons).
A Flat Category structure is typically only recommended for large communities with numerous Categories.
⭐️ EXAMPLE: Your Vanilla community needs Categories for hundreds of colleges and universities. You create this structure with Flat Categories so they're automatically sorted alphabetically.
Heading
Heading Categories are unclickable headings that exist solely to help with Category organization. No content can be added to these Categories.
📝 NOTE: On your Vanilla community Category page, Headings display according to your theme.
Generally speaking, Headings help visually organize your Categories, making it easier for your users to find the content they're looking for. Check out the image below to compare how the backend Dashboard structure translates to the front end of your Vanilla community.
Additional resources
Click the link below to access a video expanding on what you learned in this article.
