Skip to main content

How to create a Topic

  • Updated

Build a structured, folder-like repository to eliminate clutter and ensure your team can navigate complex knowledge ecosystems with ease.

Prerequisite: To create and manage Topics in Spekit, ensure you have Account Admin or Team Admin level access.

 

đź“Ś Quick-Jump Topics

 

1. How to create a Topic

Topics serve as the primary structural units for your knowledge base, requiring clear naming and visual identifiers for easy team discovery.

  1. Open the Spekit Web App.
  2. Hover over Team Hub and select + Add New â†’ Topic.

  3. Configure the following fields:

    Field Description / Instructions Example / Visual Cue
    Topic Name Choose a clear, descriptive name for your Topic. Example: “Sales Onboarding”
    Icon Add a recognizable icon for quick identification. You can use your company logo. Suggested size: 126 x 126 px, PNG. Icon placeholder
    Description Provide details about what the Topic covers and its intended audience. Example: “This Topic covers our sales tools and processes for new hires.”
    Parent Topics Assign a Parent Topic to create a Parent-Child relationship. The edited Topic becomes a Sub-Topic and will only appear within the Parent. Parent: Sales Team → Sub-Topic: Sales Onboarding
    Related Domain Specify where this Topic should appear in other apps or websites for contextual learning. Ensures it’s tied to the correct domain/subdomain. Example: app.company.com
    Target Specific Subdomains/Paths Narrow visibility to specific pages. Use the Path field for sections like /support. Add multiple domains/paths with Add Another Domain. Related Domain: app.company.comPath: /support or /help-center
    Assign Teams Select which teams can access this Topic. If shared with all teams, a lock icon indicates it cannot be removed. Team: Sales, Customer Success đź”’
  4. Click Publish to save your work.

 

đź’ˇ Pro Tip: You can also create a new Topic on the fly while assigning Speks individually or during Bulk Actions in the Content view đź’ˇ 

 

2. How to relate a Topic to a website

To target a Topic to specific websites, link it to the relevant URL. This ensures the Topic appears only on specific pages of a domain. ✨ Note: Spekit icons will only appear next to terms that exactly match the text on the linked domain or page.

  1. Open the Spekit Web App.

  2. Hover over Team Hub and select Add New → Topic (or search for an existing Topic to update and click the pencil icon).

  3. In the Domain URL contains field, enter the website URL where this Topic should appear (e.g., https://app1c.outreach.io/). 

    • Tip: Copy the full URL to avoid hidden www subdomain issues.

  4. To target additional locations, click Add Another Domain and enter extra domains or specific paths (e.g., /support). 

    • NOTE: Paths must be an exact match.

  5. Click Publish (for new Topics) or Save Topic (for updates).

 

đź’ˇ Pro Tips

  • The Related Domain field ensures your Topic is tied to the correct app or subdomain.

  • Use the Path field to restrict visibility to specific pages. Paths aren’t supported in Salesforce.

  • Spekit icons only appear next to text that exactly matches what’s on the linked page.

 

3. How to add a Sub-Topic

Sub-Topics help you organize related information under a parent Topic, keeping your knowledge hierarchy clean and easy to navigate. For Team Admins and Experts, this is the primary way to build and structure new knowledge hubs.

  1. Click Add New and hover over Sub-Topics.
  2. Choose either:
    • Create New to build a brand-new sub-topic, or
    • Add Existing to link one or more existing Topics as sub-topics.
  3. If creating a new sub-topic, enter the required details:
    • Name
    • Icon
    • Description
  4. In the Linking section, confirm the parent Topic. This will be pre-populated, but you can add additional parent Topics if needed.
  5. Select the Teams that should have access to this Topic.
  6. Click Save.

Your sub-topic will now appear nested under the selected parent Topic(s).

 

4. Governance & Team Access

Granular permission controls allow you to secure sensitive information by limiting Topic visibility to authorized teams.

✏️ Editable Fields

  • Metadata: Update Name, Description, or Icon.
  • Structure: Change Parent/Child nesting relationships.
  • Mapping: Add, edit, or remove targeted domains and paths.

đź‘Ą Managing Access

  • Control which teams can access the Topic. Within the Teams section, you can add or remove individual groups or select "Remove All."
  • đź”’ Lock Icon: Teams with "All Topics" permissions cannot be removed from individual Topics.

 

5. The "All Topics" Landing Page

The global All Topics page is now a fully customizable landing page you can shape for your team.

  • Brand Your Hub: Add your team's specific messaging and custom imagery.
  • Align Priorities: Surface current company priorities or announcements at the very top, pointing reps at what matters most the moment they open Spekit.
  • Refresh Quickly: Leverage the AI Content Builder to instantly draft and update this team-wide guidance.

 

6. Customizing Topic Headers with AI

Use the AI Content Builder to draft rich text directly into collapsible headers to provide context before users dive into Speks.
 

Provide the "Why"

Add rich onboarding context explaining exactly why these specific processes or documents matter to the team.

Post Announcements

Pin critical updates or temporary alerts to the top of the header so they are seen immediately upon opening the Topic.

Manage Detail

The polished UI features collapsible headers, ensuring that long text context doesn't crowd out the actual content cards below.

 

 

7. Curating Knowledge Playlists

Think of Playlists like a music streaming service: you can curate different "tracks" (Speks and Files) into a purposeful sequence to guide users through a learning experience.

 

Because content in Spekit is flexible, the same Spek can appear in multiple playlists, each tailored to a different initiative, persona, or sales use case. You define the flow, helping users absorb information in the exact order intended by Enablement.

 

8. How to Reorder Content

Ensure that your users consume information in a logical sequence by manually adjusting the order of Speks and Files within a Topic.

  1. Open the Topic in the Spekit Web App.

  2. Click Reorder.

  3. Drag and drop Speks or Files into the desired order.

  4. Click Save Changes.

 

By properly structuring your Topics, you ensure that content remains organized, accessible, and tailored to your team's needs. 🚀

 

9. Homepage Optimization: Getting Started

Ensure new users see the most essential training by pinning specific Topics directly to the Getting Started homepage.

  1. Open the Spekit Web App.

  2. Navigate to the Topic you want to appear on the Getting Started homepage.

  3. Click on the Edit button for the topic.

  4. In the Topic Name field, add Onboarding | at the beginning of the title (e.g., "Onboarding | Getting Started with Spekit").

  5. Click Save Changes.

By marking Topics with "Onboarding | " in the title, you ensure they are properly tagged and will automatically appear on the Getting Started homepage for new users, guiding them to the right resources.

 

Related articles