Knowledge Home Page

Customize the knowledge portal home page with navigation and links

Knowledge Home Items

Customize the knowledge portal home page with navigation items, links, and descriptions. Control what users see based on their permissions and provide a localized experience with multi-language support.

Overview

The Knowledge Home Page feature provides:

• Custom Navigation Items: Add links to knowledge sections, external resources, or specific pages
• Permission-Based Visibility: Show items only to users with specific permissions
• Multi-Language Support: Translate item names and descriptions
• Ordering Control: Arrange items in your preferred order
• Internal/External Links: Link to knowledge content or external URLs

Home Page Items

Item Properties

Property	Description
Display Name	Name shown to users (max 100 characters)
Description	Description or subtitle text
URL	Link destination (max 255 characters)
Icon	Icon displayed alongside the item
Order	Display order (lower numbers appear first)
Active	Whether the item is visible to users
External Link	Whether the URL opens an external site in a new tab
Required Permissions	Permissions needed to see this item (leave empty for all users)

---

Managing Home Page Items

Creating an Item

1. Navigate to Knowledge → Home Items
2. Click Add New
3. Configure item properties:
   • Enter display name and description
   • Set the URL (internal path or external URL)
   • Choose an icon
   • Set the display order
   • Toggle whether the item is active
   • Configure required permissions (optional)
   • Add translations for other languages (optional)
4. Click Save

Editing an Item

1. Navigate to Knowledge → Home Items
2. Click the item you want to edit
3. Update the desired properties
4. Click Save

Deleting an Item

1. Navigate to Knowledge → Home Items
2. Click the item you want to remove
3. Click Delete
4. Confirm the deletion

ℹ️ NOTE: Home page items can also be managed via API. See the Public API v1 Reference for endpoint details.

---

Multi-Language Translations

Each home page item can have translations for different languages.

Translation Properties

Property	Description
Language Code	ISO language code (e.g., “en”, “fr”, “es”)
Display Name	Translated display name
Description	Translated description

How Translations Work

1. User visits portal: System detects user’s language preference
2. Check for translation: Look for translation matching user’s language
3. Display result:
   • If translation exists: Show translated name and description
   • If no translation: Show the default display name and description

Supported Languages

Code	Language	Code	Language
en	English	pt	Portuguese
fr	French	nl	Dutch
es	Spanish	pl	Polish
de	German	ru	Russian
it	Italian	ja	Japanese
ko	Korean	zh	Chinese
ar	Arabic	tr	Turkish

---

Permission-Based Visibility

Control which users can see each home page item based on their permissions.

Setting Permissions

1. Create the permission in Settings → User Management → Access Control
2. When creating or editing a home page item, select the required permissions
3. Only users with the selected permissions will see the item

Visibility Rules

Scenario	Item Visible?
No permissions required	Yes (all users)
User has required permission	Yes
User lacks required permission	No
Item is inactive	No (except in admin view)

---

Ordering Items

Items are displayed in order by:

1. Order value (ascending — lower numbers first)
2. Display name (alphabetically, as tiebreaker)

Example Order Configuration

Item	Order	Position
Getting Started	1	First
FAQs	2	Second
Tutorials	3	Third
Contact Support	99	Last

---

Internal vs External Links

Internal Links

• Leave the External Link toggle off
• Use relative paths (e.g., /knowledge/section-name)
• Opens within the portal

External Links

• Enable the External Link toggle
• Use full URLs (e.g., https://external-site.com/docs)
• Opens in a new tab/window

---

Best Practices

Organization

• Use consistent ordering across your portal
• Group related content with similar order numbers
• Keep the most important items at the top

Naming

• Use clear, descriptive display names
• Keep descriptions concise but helpful
• Verify translations are accurate

Permissions

• Use permissions sparingly for a simpler experience
• Test visibility with different user types
• Document which permissions are required for each section

---

Related

• Knowledge Overview — Feature overview