How do I create a Topic?

SKIP AHEAD TO: How to Create a Topic in Spekit How to Relate a Topic to a Website  How to Add More URLs to a Topic How to Edit a Topic How to Remove Teams from a Topic How to Create a Sub-Topic How to Remove a Sub-Topic How to Reorder Content in a Topic  How to Mark Topics to appear on the Getting Started Homepage

Learn how to create Topics. You must have Account Admin or Team Admin-level access to create Topics. 

 

How to create a Topic in Spekit

Topics can group your content by Team, process, or any other bucket for easy searching and filtering.

1.) Open the Spekit Web App and click on Wiki.

2.) Click New and select Topic from the drop-down.

3.) In the Topic creation modal, customize your Topic with the following:

• Topic Name: Choose a clear, descriptive name.
• Icon: Add a recognizable icon for quick identification. You can use your company logo (Suggested size: 126 x 126 pixels, PNG).
• Description: Provide details about what the Topic covers and its intended audience.

• Related Domain: Specify where this Topic should appear in other apps or websites for contextual learning. This ensures the Topic is tied to the correct domain or subdomain.

  • Target Specific Subdomains/Paths: Define where the Topic should be visible. For example, you can target a specific section of a site by specifying its path (e.g., /support).
  • To target multiple locations, click Add More to add additional domains or paths. This allows you to map the Topic across multiple areas as needed. 
    • • The Related Domain field ensures that the Topic is connected to the proper domain or subdomain.
      • The Path field lets you narrow the Topic’s visibility to specific pages within that domain.
  •  Assign Teams: Control visibility by selecting the teams that can access this Topic. If a Topic is shared with all teams, a lock icon will appear, indicating it cannot be removed.

•  

4.) Once you've completed the fields, click Create Topic to save your work.

 

💡 PRO TIP: You can also create a new Topic while assigning it to one or more Speks, either individually or in bulk using the bulk actions feature 💡

💡 PRO TIP: When assigning Topics to Speks, you can also configure Topic Targeting to ensure Speks appear only on the relevant web pages associated with the Topic. 💡 

 

How to Relate a Topic to a Website 

To target a Topic to specific websites, you need to link it to the relevant URL. This is particularly useful for ensuring that the Topic appears only on specific pages of a domain.

1.) Open the Spekit Web App, and click New.

2.) Click Topic.

3.) In the Domain URL contains field, enter the website URL where this Topic should appear (e.g.,

 https://app1c.outreach.io/)

4.) Click Create Topic to finalize. 

 

💡 PRO TIP: Spekit icons will only appear next to terms that match text on the linked domain. For example, if your Topic is associated with https://app1c.outreach.io/ , Speks will only display for text relevant to Outreach💡

 

How to Add More URLs to a Topic

1.) Navigate to the Spekit Web App.

2.) Use the search bar to find the Topic you want to update.

3.) Hover over the Topic and click the pencil icon to edit.

4.) Scroll down to the Domain URL section, and click Add another domain.

5.) Enter the additional URL(s) and click Save Topic to update the Topic.

 

How to Edit a Topic

1.) Open the Spekit Web App, and click Wiki.

2.) Locate and click the Topic you want to modify.

3.) Click the pencil icon to edit.

 

4.) A pop-up will appear where you will be able to edit the Topic. You will be able to edit: 

• Topic Name: Update the name of the Topic.
• Description: Modify the description to clarify the Topic’s purpose or content.
• Parent Topics: Assigning a Parent Topic creates a Parent-Child relationship. This Topic will become a Sub-Topic and will only be visible within its Parent Topic. It will not appear on the Topics page. 
• Icon: Change or add an icon.
• URL Mapping (if applicable):
  • Add, edit, or remove domains, subdomains, or paths to specify where the Topic appears.
• Teams: Adjust which teams can access the Topic.
• Delete the Topic: Remove the Topic if it is no longer needed.

 

5.) Once you’ve made your edits, click the Save changes button at the bottom of the pop-up to finalize your changes.

 

NOTE: Teams with "All Topics" permission will display a lock indicator next to their name. These teams cannot be removed from the Topic.

 

 

How to Remove Teams from a Topic

1.) Open the Spekit Web App, and click Wiki.

2.) Identify and click on the Topic you would like to edit. 

3.) Click the Edit Topic button. 

4.) A pop-up will appear where you will be able to edit the Topic. You will be able to edit: 

• Topic Name: Update the name of the Topic.
• Parent Topics: Assigning a Parent Topic creates a Parent-Child relationship. This Topic will become a Sub-Topic and will only be visible within its Parent Topic. It will not appear on the Topics page. 
• Icon: Change or add an icon.
• URL Mapping (if applicable):
  • Add, edit, or remove domains, subdomains, or paths to specify where the Topic appears.
• Teams: Adjust which teams can access the Topic.
• Delete the Topic: Remove the Topic if it is no longer needed.

5.) Scroll down to the Team that can access this topic section.

6.) From here you will be able to add teams to the Topic, remove a team's access to the Topic, or remove all teams from the Topic. 

7.) Click Save changes when you are done. 

 

 

How to Create a Sub-Topic

1.) Open the Spekit Web App.

2.) Find the Topic you would like to make a Sub-Topic. 

3.) Click Edit. 

4.) Assign a Parent Topic to nest it under an existing Topic.

5.) Click Save to confirm the new hierarchy.

 

How to Remove a Sub-Topic

1.) Open the Spekit Web App.

2.) Find the Topic you would like to remove as a Sub-Topic.

3.) Click Edit. 

4.) Open the Parent Topic dropdown, and click whichever Topic you would like to remove.

5.) Click Save to confirm the new hierarchy.

 

How to Reorder Content in a Topic

Learn how to reorder content in a Topic. You must have Account Admin or Team Admin-level access to reorder content in a Topic.

 

 

1.) Open the Spekit Web App.

2.) Navigate to the Topic where you want to reorder content.

3.) Click the Reorder button. 

4.) Drag and drop content into the desired order by clicking and holding to move it.

5.) Click Save Changes to apply your updates. The content will now be displayed in the updated order within the Topic.

 

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

 

How to Mark Topics to appear on the Getting Started Homepage