Articles in this section

[Admin & Rep Guide] Spek overview and setup

A Spek is a small, focused piece of knowledge that your team can read inside the tools they already use. This guide explains what a Spek is, who can create one, and what each control in the Spek editor does.

 

1. What is a Spek?

A Spek is a bite-sized, customizable piece of knowledge. Think of it as a short help article or a digital flashcard. Your team can open it at the moment they need it, inside the tools they use every day.

Use Speks for:

Use case Example
Step-by-step walkthroughs How to log a call in Salesforce
Internal processes The approval path for a discount
Definitions What ARR means at your company
Best practices How to run a discovery call

Small chunks are easier to find and easier to keep current. They also cut down on knowledge that only lives in people's heads.

💡 Pro Tip: If a Spek covers more than 1 task, split it into 2. Short Speks get read. Long ones get skimmed.

 

2. Who can create Speks?

You need an Account Admin, Team Admin, or Expert role.

ℹ️ Note: If you do not have one of these roles, ask your admin. They can update your access on the User Management screen in Spekit Settings.

 

3. The Spek editor at a glance

The editor has 2 parts. The writing area sits in the middle. The AI Content Builder panel sits on the left and can be collapsed. Click here to learn more about the rich text editor. 

These controls sit along the top:

#

Control What it does

1

Title field Names your Spek

2

✨ Smart Title Sends your draft to Spekit AI and writes a title for you. Greyed out until you add content

3

Doc / Slides Switches between a document and a deck. See section 4

4

Preview Opens your Spek full screen as a branded presentation, so you can check it before you publish. Press ESC to exit. Once published, the same view is called Present

5

🗑️ Delete Deletes the Spek. Only appears when editing an existing Spek

6

⚙️ Settings Opens the full settings area. See sections 5 and 6

7

Save Opens the save menu. Choose Publish or Draft. See section 7

8

X Closes the editor without saving

💡 Pro Tip: Settings used to sit below the content area. They now live behind the gear icon. Click Return to edit Spek to come back to your writing.

💡 Pro Tip: Write your content first, then click Smart Title. The button needs content before it will work, and a title written from a finished draft is usually sharper than one you guess at the start.

 

4. Write your content

Doc or Slides

A Spek can be a document or a deck. Pick before you start, because the choice cannot be undone.

Mode What you get
Doc A standard document. Best for processes, definitions, and guides
Slides A deck on a 16:9 canvas, with a film strip of every slide beside it. Best for anything you will present or hand to a buyer

ℹ️ Note: Slides is in Beta, so you will see a BETA label next to the Doc and Slides toggle.

💡 Pro Tip: Pick your mode before you start. A Spek saved as Slides cannot be turned back into a Doc. Slides are formatted differently from a document, so converting between the 2 would break that formatting.

Add content to the page

You have 3 ways to build a Spek:

Method How
Write or paste Type directly, or paste a draft and ask the AI Content Builder to reshape it
Insert menu Click Insert to add Spekit content, an embed or iframe link, a table, a file, a logo, a link, an emoji, a code block, or a divider
Keyboard shortcuts Type @ to embed a file. Type / to open the component library. Drag and drop also works

💡 Pro Tip: The / menu holds more than text formatting. It has headers, cards, callouts, grids, and logos that follow your Brand Studio settings, so content comes out on brand without styling it by hand.

💡 Pro Tip: In Slides mode, each Section becomes its own slide. Type / and insert a Section wherever you want a slide break.

AI Content Builder

The panel has 2 tabs. Click here to learn more about the AI Content Builder.

Tab What it does
Create Give the builder an instruction and it writes into your Spek
Similar Checks for content that already exists, so you do not create a duplicate

Attach a source for better results:

Source Limit
Transcripts 1 transcript. Search your calls, or upload a transcript
Spekit Your existing Spekit content
Web 1 web source. Enter a search term and Spekit adds what it finds

Prompts can be up to 1700 characters.

ℹ️ Note: AI can make mistakes. Always check the content before you publish.

 

5. Spek settings

Click the ⚙️ gear icon to open settings. There are 2 tabs: Settings and Custom Fields.

The Settings tab holds these fields:

#

Field What it does

1

Type Content is a standard Spek. Template is a reusable starting point for the template gallery. Template adds a "Template instructions" field to guide users and AI

2

Add to Topics (required) Topics decide who can access this Spek and which domains it appears on. The dropdown only shows Topics you can publish into. Use + Create Topic to make a new one

3

External sharing Off by default. Only people in your company can view the Spek. Turn it on to let users share it with a trackable link or add it to a Deal Room

4

Assign an Expert Names the person responsible for this content. They get a notification. Defaults to you

5

Add to Learning Paths Adds the Spek as an item in an existing Learning Path

6

Assign to Salesforce Objects Chooses where this Spek appears in Salesforce. Reps see it on pages for the objects you pick

7

Must see content? Turn on to make the Spek appear in each user's "Overview & Insights"

ℹ️ Note: Some fields only appear if your organization has that feature turned on. Templates, Learning Paths, and Salesforce objects are the common examples. Templates cannot be shared externally unless your organization also has Deal Rooms.

💡 Pro Tip: Topics can be limited to certain teams. Only people on a team with access to that Topic can see the Speks inside it. Manage this in the Topic's own settings.

💡 Pro Tip: Leave External sharing off unless you have a reason to turn it on. You can switch it on later when a rep actually needs to send the content outside your company.

 

6. Custom fields

The Custom Fields tab holds extra fields your admin has set up for your company. "Category" is a common example.

These are not built in. Your Spekit admin creates them under Admin Tools and decides which content types they apply to. They can be text, multi-select, or date fields. Use them to organize and search your content.

 

7. Save your Spek

Click Save as to open the save menu. You have 2 choices.

Option What happens
Publish The Spek goes live. People with access to its Topics can see it
Draft The Spek is saved but not live. Only you and other content creators can see it

The save menu also holds a short Settings panel, so you can set the essentials without leaving the menu:

Field Note
Topics (required) Pick 1 or more. Click Edit to open the list
Learning Paths Shows "None" until you add one
External sharing A toggle, off by default

Click All settings to open the full settings panel described in sections 5 and 6.

To publish without telling anyone, leave Notify users unticked and click Publish. The Spek goes live quietly.

You can change any field later. To leave without saving, click the X in the top corner.

💡 Pro Tip: Use Draft while you are still working. Publish quietly for small fixes. Save notifications for changes your team needs to act on.

 

8. Notify your team

Tick Notify users before you click Publish. If you click Publish first, the Spek goes live with no notification.

  1. Click Save as.
  2. Tick the Notify users checkbox next to Publish.
  3. Click Publish.
  4. The Notify users window opens.
  5. Select the Teams you want to notify. This is required.
  6. Write a Message. This is required.
  7. Choose how to deliver it. You can pick more than 1.
  8. Click Publish changes and notify users.

Delivery options:

Option What it does
In-app notification Shows in Spekit
Email Sends an email
Create Spotlight After publishing, you are prompted to create a Spotlight that links to this Spek

The button stays greyed out until you have chosen Teams and written a message. Click Cancel to close the window without publishing.

💡 Pro Tip: Keep the message short. Say what changed and why it matters. "Updated pricing objection handling for the new Q4 tiers" beats "This Spek has been updated".

💡 Pro Tip: Notify only when the change is worth an interruption. Your team will tune out notifications if every small fix sends one.

 

9. Best practices

These habits keep your content easy to find, easy to trust, and easy to maintain over time.

Practice Why it matters
Keep 1 Spek to 1 task Readers scan. A Spek that answers 1 question gets used. A Spek that answers 5 gets abandoned halfway
Name it the way people search Write the title the way a rep would ask the question, not the way the process is named internally
Always assign an Expert Content without an owner goes stale. The Expert is who people chase when something looks wrong
Add to more than 1 Topic when it fits A Spek can live in several Topics at once. A pricing objection can sit in both "Objections" and "Pricing"
Check Similar before you create Stops duplicates before they exist. Two Speks on 1 subject means 2 answers and 1 wrong one
Review AI output line by line The builder drafts fast, but it can get details wrong. You own what gets published
Use Preview before you save What you see in the editor is not always what the reader sees, especially in Slides mode
Save as Draft while you work Nobody sees half-finished content, and you keep your progress
Was this article helpful?
0 out of 0 found this helpful