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.
- Click Save as.
- Tick the Notify users checkbox next to Publish.
- Click Publish.
- The Notify users window opens.
- Select the Teams you want to notify. This is required.
- Write a Message. This is required.
- Choose how to deliver it. You can pick more than 1.
- Click Publish changes and notify users.
Delivery options:
| Option | What it does |
|---|---|
| In-app notification | Shows in Spekit |
| 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 |