Compass Search

Verification unlock: This feature is available for verified websites. Verify your site now so Compass Search can index the right pages and stay reliable for visitors. Start here: Brands, Domains & Verification.

Compass Search lets visitors quickly find pages and content on your site using the pages The Credibility Compass has indexed from your scans.

This page focuses on what users need to do to turn it on, connect it to the right brand, and match it to their own visual style.

What Visitors See

When Compass Search is enabled:

• A small floating search button appears on your site.
• A “command palette” style search box opens when visitors:
• Click the floating button, or
• Use a keyboard shortcut (by default Ctrl+K / ⌘K).
• Typing in the box shows matching pages (title, path, short snippet).

You choose which brand it belongs to and how it looks; The Credibility Compass takes care of the search logic.

Step 1 – Get Your Brand Token

Compass Search uses your brand's verification token to know which site to search.

To find it:

1. Go to your brand in The Credibility Compass.
2. Open Brand Settings (or the verification / tracking section).
3. Look for the verification token (the same value used by the site client).

You’ll use this value as data-site-id in the recommended site client.

Step 2 – Install the Site Client

Install the recommended CredibilityCompass site client on your website. The canonical setup instructions live in Brands, Domains & Verification.

Add this script before the closing </body> tag on your site:

<script src="https://cdn.credibilitycompass.com/cc-loader.js" data-site-id="YOUR_BRAND_TOKEN" defer></script>

Replace:

• YOUR_BRAND_TOKEN with your actual verification token.

Once this is deployed:

• The site client can verify the site token.
• UX signals and user journey events can start collecting when available.
• Site Assistant search and AI answer experiences load only when enabled for this brand.

Step 3 – Enable Compass Search for the Brand

The site client is shared across verification, UX insights, user journeys, campaigns, Compass Search, and Compass AI. Installing the script does not automatically show search to visitors unless Compass Search is enabled for the brand.

In The Credibility Compass:

1. Open the brand settings or Site Assistant settings.
2. Enable Compass Search for that brand.
3. Configure the search label, placeholder, accent color, and any available behavior settings.
4. Save and test the site where the client script is installed.

Once enabled:

• The floating search entry point should appear according to the brand settings.
• The configured keyboard shortcut, if enabled, should open the search panel.

Step 4 – Match Search to Your Brand

Compass Search can use your brand settings for labels, placeholder copy, accent color, and related experience options. Keep these settings consistent with your website's visual system and make sure accent colors have enough contrast for result titles and highlights.

Optional – Use the Meta Tag Only as a Fallback

If you cannot install the site client yet, you can use the meta tag fallback from Brands, Domains & Verification for ownership verification:

<meta name="cc-verification" content="YOUR_BRAND_TOKEN">

The meta tag does not load Compass Search. Install the site client when you are ready to show search or collect first-party engagement data.

When Search Results Might Be Empty

Compass Search uses pages that have already been scanned for your brand.

You may see few or no results if:

• You haven’t run many page scans yet.
• The pages you expect to see belong to a different brand in The Credibility Compass.

To improve coverage:

• Run scans on your most important pages (home, pricing, docs, key content).
• Re-scan sections after major site updates.
• After publishing content edits, run a fresh scan so search reflects the latest page version.

Keeping Search Results Fresh

Compass Search freshness depends on scan freshness.

• If you update copy, headings, offers, or page structure, re-scan those pages.
• Treat scans as your index refresh cycle in CC.
• For actively changing sites, schedule periodic rescans of key pages (homepage, pricing, product pages, docs, FAQs).

Quick Checklist

To get Compass Search working and on-brand:

• [ ] Brand is created and verified in The Credibility Compass.
• [ ] You know your verification token for that brand.
• [ ] The site client <script> is added before the closing </body> tag with data-site-id set.
• [ ] Compass Search is enabled for the brand in The Credibility Compass.
• [ ] Search label, placeholder, accent color, and available behavior settings match your brand.
• [ ] You’ve run scans on the pages you want to appear in search.

For deeper API-level details (for example, building your own custom search UI), see the Compass Search developer document under Developer Docs.