> ## Documentation Index
> Fetch the complete documentation index at: https://amethystapps.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Search Pulse Guide

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.

<a href="https://apps.shopify.com/partners/amethyst-apps" class="btn-amethyst-install">
  View App Details →
</a>

> **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:

### Appearance & Search Bar

* **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.

<div class="glass-callout">
  ### 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](mailto:support@amethystapps.com)
</div>

<br />

<a href="https://apps.shopify.com/partners/amethyst-apps" class="btn-amethyst-install">
  Get Search Pulse Now →
</a>