Sections are the top-level content groups in your portal. They appear as cards on your portal home page and each gets its own navigation and landing page.

---

What are sections?

Every portal starts with three built-in sections that cover the most common content types. You can add custom sections on top of these to match your product's structure — for example an API Reference, Tutorials, or Release Notes section that lives alongside the defaults.

Sections are managed from Editor → Sections.

---

The three system sections

Three sections are built into every portal and cannot be deleted. They can be renamed, re-described, and given a new icon, but their URL slugs are fixed.

Section	Fixed URL slug	Content type
Documentation	/docs	Articles organised by category
FAQs	/faqs	Frequently asked questions
Product Updates	/changelog	Chronological product changelog

Note: The Documentation section is the default home for all categories. Any category not explicitly assigned to another section lives here.

---

Creating a custom section

1. Go to Editor → Sections.
2. Click New Section in the top-right corner.
3. Fill in the details in the slide-in panel:
   • Name — shown on the portal home card and section landing page.
   • Icon — pick from the icon library to give the section a visual identity.
   • URL slug — auto-derived from the name; must be lowercase kebab-case (e.g. api-reference). Certain reserved slugs (docs, faqs, changelog, articles, category) cannot be used.
   • Description — optional one-liner shown on the section card on the home page.
4. Click Create.

The new section immediately appears on the Sections list. It won't show on your portal until you assign at least one category to it and set its visibility to on.

---

Editing a section

Click Edit on any row to open the edit panel.

For custom sections

All fields are editable: name, icon, slug, and description. Changing the slug updates the live URL for that section — any existing links to the old path will break, so rename slugs with care.

For built-in sections

Name, icon, and description are editable. The URL slug is locked and cannot be changed, ensuring stable URLs for Documentation (/docs), FAQs (/faqs), and Product Updates (/changelog).

---

Controlling visibility

Each section has a Visible toggle in the sections table. Turning a section off hides it from the portal home page and its landing page becomes inaccessible to visitors — without deleting any content.

This is useful for:

• Hiding a section you're still building out.
• Temporarily removing a section without losing its categories and articles.
• Keeping built-in sections (like FAQs) off the portal if you don't use them.

---

Assigning categories to a section

Categories are assigned to sections from the Categories editor, not from the Sections page.

1. Go to Editor → Categories.
2. Click Edit on a category.
3. In the edit panel, use the Section dropdown to pick which section it belongs to.
4. Click Update.

All articles inside that category will automatically appear under the chosen section in the portal.

If you delete a custom section, every category assigned to it is automatically moved back to Documentation.

---

Reordering categories within a section

The order of categories inside a section controls how they appear in the section's sidebar navigation.

1. Open Editor → Sections and click Edit on the section you want to arrange.
2. Scroll to the Category Order list in the edit panel — it shows all categories currently assigned to that section.
3. Drag any category up or down to your preferred position.
4. The new order is saved automatically when you drop.