CGB Visual Search Documentation

Getting Started

CGB Visual Search lets your WooCommerce customers search products using images. Upload a photo and our AI finds matching products in your store.

1. Create an account at the Client Dashboard
2. Install the WordPress plugin
3. Connect your WooCommerce store
4. Sync your products
5. Add the search widget to your site

Installation

Method 1: WordPress Admin

1. Download the plugin ZIP from the Client Dashboard
2. Go to WordPress Admin → Plugins → Add New → Upload Plugin
3. Upload the ZIP file and click "Install Now"
4. Activate the plugin

Method 2: FTP Upload

1. Extract the ZIP file
2. Upload the cgb-visual-search folder to /wp-content/plugins/
3. Activate from WordPress Admin → Plugins

Configuration

After activation, go to CGB Visual Search in your WordPress admin menu.

1. Login — Use your CGB account credentials
2. Connect WooCommerce — Click the connect button; this generates API keys automatically
3. Sync Products — Click "Sync Products" to index your store catalog

Shortcode Widget

Add the visual search widget to any page or post using the shortcode:

[cgb_visual_search]

This creates a drag-and-drop upload area with search results displayed below.

Floating Search Bar

The floating search bar appears as a camera icon on every page of your store. Customers click it to open a search modal.

To disable the floating bar, go to CGB Visual Search settings in WordPress admin and uncheck "Enable Floating Search Bar".

Webhooks

When you connect WooCommerce, webhooks are automatically registered for product create, update, and delete events. This keeps your search index in sync.

Multi-Store Management

CGB Visual Search supports connecting multiple WooCommerce stores from a single account. The number of stores you can connect depends on your plan.

Store Limits by Plan

Adding a Store

1. Go to your Client Dashboard
2. Click "+ Add Store" in the Connected Stores section
3. A new Store ID and Secret Code will be generated
4. Install the plugin on your WordPress site and enter the Store ID and Secret Code

Per-Store Configuration

Each store has its own unique Store ID and Secret Code. This means:

• Each WordPress site connects with its own credentials
• Products are indexed separately per store
• Search usage is tracked independently per store
• Customization settings (colors, layout, CSS) are per-store

Plan Limit Enforcement

If you exceed your plan's store limit, additional stores will be locked. For example, if you downgrade from Pro+ (3 stores) to Pro (1 store), only your first store remains active. The other stores are preserved but disabled until you upgrade again.

FAQ