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.

      ezgif-1-10d35341d4.gif

  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. 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.

 

4. 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.

 

5. 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.

 

ezgif-5114339e38fbe6.gif

 

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

 

6. 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