How to create and manage a Topic

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.

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. There are two ways to create a Topic in the Spekit Web App:
   • Click Hub, select Topics, and click + New Topic, or
   • Click + New and select "Create a Topic Page to organize your content."

3. Configure the following fields:

   Field	Description / Instructions	Example
   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 example image]
   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.com Path: /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. 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. Add a 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. 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.

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