Find exactly what you need, exactly when you need it. Discover how Spekit’s AI-powered engine ranks, surfaces, and optimizes your organization's knowledge.
Spekit leverages a powerful Algolia integration to handle typos, synonyms, and complex keyword matching, ensuring that the "Execution Layer" of your knowledge base is always responsive and accurate.
📌 Quick-Jump Topics
- 1. The Intelligence Layer: How Ranking Works
- 2. Searchable Content & Visibility
- 3. Navigation & Workflow Rules
- 4. Advanced Search Entry Points
- 5. Optimization Strategy: Designing for Search
1. The Intelligence Layer: How Ranking Works
Spekit doesn't just look for words; it looks for relevance. Results are ranked based on a weighted hierarchy to ensure the best answer is always at the top.
Title Priority
Keywords appearing at the start of a Spek or File title receive the highest ranking boost.
Definition Relevance
The system scans the body of content, prioritizing matches found in the first 40,000 characters.
Multi-Term Matching
Results containing all search terms appearing together rank significantly higher than partial matches.
Metadata & Custom Fields
Custom fields are fully searchable but carry lower ranking weight than titles and body content.
Technical Relevancy Factors
| Factor | How it Enhances Your Experience |
|---|---|
| Typo Tolerance | Automatically accounts for minor misspellings (e.g., "opprotunity") to prevent empty result pages. |
| Word Proximity | Terms appearing closer together in a sentence result in a higher relevance score. |
| Singular vs. Plural | Spekit recognizes root words, ensuring a search for "customers" also finds content labeled "customer." |
| AI Synonyms | Leverages Algolia AI to apply global synonyms (e.g., Intro ↔ Introduction, Client ↔ Customer, Holiday ↔ Vacation). |
2. Searchable Content & Visibility
The Universal Search bar queries almost everything in your library, but visibility depends on your specific role and feature access:
🔍 What is Searchable?
- Speks: (Title, Body, & Tags)
- Files: (Title & Metadata)
- Topics: (Title & Description)
- Knowledge Checks: (Titles)
- Spotlights: (Admins & Experts Only)
🔒 Visual Indicators for Governance
-
🌍 Globe Icon: Content is shareable externally via Trackable Links.
-
👻 Hidden Icon: (Admins Only) Content is hidden from Viewers for review or updates.
-
⚡ Empty Speks: (Admins Only) Surfaces "undocumented" items that require content.
3. Navigation & Workflow Rules
🔄 Returning to Results
Web App: Use the browser back button to return to your list.
Chrome Extension: The back button is not supported for search. To return, click the search icon and re-run your query.
🚫 Filters & Sorting
Filters and manual sorting are disabled on the active Search Results page. To use advanced filters, navigate back to the Library or Content view.
4. Advanced Search Entry Points
The List View Search (Content Tab)
Ideal for Admins performing audits or managing large Spek volumes.
- Navigate to the Web App.
- Select the Team Hub tab.
- Choose Content and then List View.
- Use the Search bar to find specific terms.
NOTE: This search is specific to Spek titles and bodies only.
Accessing Recently Viewed Content
Jump back into your active projects instantly.
- Navigate to the Web App.
- Click into the Universal Search Bar.
- View your 10 most recently accessed Speks and Files and click to reopen.
5. Optimization Strategy: Designing for Search
Admins and Experts can significantly improve the user experience by building content that matches Spekit’s ranking logic:
- Front-load Keywords: Place the most critical terms at the beginning of your Spek titles.
- Strategic First Paragraphs: Ensure the first part of your definition clearly defines the term to maximize ranking weight.
- Tag Placement: If using tags within a Spek, place them at the very beginning of the body.
- Leverage Synonyms: Use AI synonyms to ensure "Cust. Success" finds the same info as "Customer Success."
- Testing Queries: Test different search variations to see exactly where your content lands in the results list.
- Monitor Feedback: Review user "confused" reactions to identify where search results are missing the mark.