How to Create a Spek

Learn how to create Speks wherever your team works — whether it's in the Spekit Web App, the Chrome Extension, directly within your everyday tools like Salesforce and Slack, or even embedded in the applications your team uses most.

Where Can I Create a Spek?

You can create Speks from three different places:

• The Web App
• The Chrome Extension
• Slack

New to creating Speks? Start with Spek Overview & Setup to learn what a Spek is and how it fits into your team's overall content structure. Once you're creating content, check out How do I use Spekit's Rich Text Editor? for everything on formatting your Spek — from the toolbar and tables to embedding GIFs, PDFs, and iframes.

Option 1: The Spekit Web App

You can create Speks in two different ways from the Spekit Web App:

Create a Spek using the +New button

1. Open the Spekit Web App.
2. Click on the +New button in the top navigation bar.
3. A pop-up will appear on the screen, select Create a Spek.

Create a Spek from the Topic View

1. Open the Spekit Web App.
2. Click on Hub and select Topics.
3. Navigate to the Topic you would like to add content to.
4. Click the Add New button.
5. A pop-up will appear on the screen, select Spek.

Option 2: The Spekit Chrome Extension

You can create Speks in two different ways from the Chrome Extension:

Create a Spek from the Spekit Chrome Extension

Simply open your extension by clicking on the Dock to pop open the sidebar, or click on the Spekit icon in your extension toolbar.

1. Open the Spekit Chrome Extension (also known as Sidekick).
2. Click on +New in the top navigation bar.
3. A pop-up will appear on the screen, select Spek.

Create a Spek Using the Salesforce Integration for an Existing Field, Picklist, or Object

Our unique Salesforce integration allows you to import fields and picklists from any object into Spekit. Make sure you've imported the object and synced it with Salesforce after the field was added, so it shows up in Spekit. Learn more about our Salesforce integration here.

To add a Spek next to your existing field:

1. Open the Spekit Chrome Extension.
2. Search for that field in the sidebar, or highlight the field label and press Shift + Command + S on Mac to find it.

3. To find your empty field or picklist Speks, search for the name and filter by Speks. You can also filter by "Only show undocumented Speks."
4. Toggle on Only show empty Speks.
5. You'll now see empty Speks that need definitions.
6. Open any Spek you'd like and click Edit to add content to that Spek.

Option 3: Slack

Prerequisite: Install the Slack Integration. Read more about our Slack Integration here.

Use the overflow menu to create a Spek from an existing message:

1. Click on the three dots.
2. Select the Connect to Apps option.
3. Click on Create a Spek.

Use Case: Use the overflow menu to create a Spek from a message. It'll auto-populate the definition for you so you can re-use the answer in the future.

Note: Currently, the ability to create a Spek directly via the /spekit create command in Slack has been removed as part of the recent Slack integration updates.