Skip to main content

Documentation Index

Fetch the complete documentation index at: https://amethystapps.com/llms.txt

Use this file to discover all available pages before exploring further.

Everything you need to know to install, configure, and customize Search Pulse for your BigCommerce or Shopify store.

Search Pulse — Installation Guide

Search Pulse by Amethyst is a premium instant search app that replaces or supplements your theme’s native search with a lightning-fast, fully customizable experience.

Key Capabilities at a Glance

  • Instant Search: Search-as-you-type results for products, pages, categories/collections, and blogs.
  • Two Display Modes: Choose between a Floating Button or an Embedded Search Bar.
  • Per-Page Control: Set different search modes for Home, Product, Blog, and Category pages.
  • Smart Filtering: Instant filters for product type, vendor/brand, and price range.
  • Merchandising: Boost specific products, create synonyms, or set up search redirects.
  • Visual Control: Full mastery over colors, 10+ Google Fonts, icons, and custom CSS.
  • Inventory Smart: Automatically hide out-of-stock products or specific vendors.

Step 1: Install the App

Visit the Shopify App Store or BigCommerce App Marketplace and search for Search Pulse. Click Install and approve the required permissions. View App Details →
Note: The app only requests read access to your store’s content (products, pages, blogs)—it never modifies your core store data.

Step 2: Complete the Setup Wizard

After installation, you’ll be taken to the Search Pulse dashboard. A quick 3-step wizard will walk you through:
  1. Welcome Screen: An introduction to the app’s core features.
  2. Display Mode — Choose between Float (floating button) or Embed (inline bar).
  3. Accent Color — Pick a color that matches your brand’s look and feel.

Step 3: Enable the Storefront Integration

Search Pulse is delivered through high-performance scripts or theme extensions to ensure it stays live and fast. For Shopify:
  1. In your Admin, go to Online Store → Themes → Customize.
  2. Click App embeds (the puzzle piece icon).
  3. Find Search Pulse and toggle it ON, then click Save.
For BigCommerce:
  1. In your Dashboard, go to Storefront → Script Manager.
  2. Ensure the Search Pulse script is active.
  3. If using Embed mode, place the provided <div> tag into your theme’s HTML where you want the search bar to appear.

Step 4: Customize Your Settings (Optional)

Fine-tune your search experience in the app dashboard:
  • Visual Styling: Customize button colors, choose from 8 icon styles, and set your font.
  • Sizing & Alignment: Adjust the width, height, and border-radius of the search bar.
  • Positioning: For Float mode, set custom X and Y offsets for pixel-perfect placement.
  • Hide Native Search: Toggle “Hide native search bar” to remove your theme’s default search.

Content & Filters

  • Content Toggles: Independently enable or disable search for Products, Pages, Categories, and Blog Articles.
  • Smart Filters: Toggle filters for Product Type, Vendor/Brand, and Price Range.
  • Inventory Rules: Enable “Hide out of stock products” to keep your results clean and shoppable.

Step 5: Explore Advanced Features

Once you’re up and running, check out these powerful merchandising tools:
  • Synonyms: Group related terms (e.g., “hoodie, sweatshirt, pullover”) so they return the same results.
  • Product Boosts: Pin specific products to the top of results for certain search terms.
  • Search Redirects: Send users to specific URLs (like /pages/contact) when they search specific terms.
  • Analytics: Track search volume, top searches, “no-result” queries, and click-through rates.

Requirements

  • Themes: Supports all modern Shopify OS 2.0 and BigCommerce Stencil themes.
  • Setup: No complex coding required; fully responsive on desktop and mobile.
  • Sync: Automatic data sync via platform webhooks ensures your results stay up to date.

Need Help?

If you run into any issues with a specific theme layout or need help with custom CSS styling, our team is ready to help. Contact Amethyst Support

Get Search Pulse Now →