Getting started

Welcome. There are two routes through the product depending on how you connected. Use the one that matches your install. Either way, the dashboard is where you spend your time, and docs.veryquery.com is the API reference whenever you need it.

New on a Starter trial? Skip ahead to Evaluating your trial for a 14-day path through the product.

If you connected via Shopify

Your catalog syncs automatically from the moment you finish OAuth, and Shopify Billing handles charges. The rest is dropping the right blocks into your theme and dialing them in.

Step 1

Connect your store

Done if you came in through the App Store install. Worth a read for what the install actually configured.

Step 2

Storefront search

Adds the VeryQuery search bar and results page to your theme.

Step 3

Smart Categories

Turns category and collection pages into intent-aware grids.

Step 4

Similar items

Drops a "you might also like" row onto product pages.

Step 5

Trending items

A row that follows what your shoppers are searching for, with an auto-detected headline.

Step 6

Curated items

Themed rows you compose by writing a short brief in the theme editor.

Step 7

Match your brand

Adjusts the storefront components' look to fit your theme.

Step 8

Signals capture

Lets us learn from what your shoppers do, so results sharpen over time.

Step 9

Shopper actions

The events VeryQuery reads from your storefront and what each one informs.

Once a few weeks of search traffic is in, the Intelligence map starts painting a real picture of what your shoppers are asking for, and Search Lab lets you spot-check relevance against your own catalog at any time.

If you're using the API

You drive ingest and search calls yourself. The dashboard is still useful, mostly for observability (what's indexed, what shoppers searched, your catalog cap, intelligence) and for the API keys you'll need to make calls.

Step 1

Settings

Mint an API key here.

Step 2

Items

Ingest your catalog through POST /v1/items. The items list shows you what's indexed and the processing state of each one.

Step 3

Search Lab

Once items are ready, run a query from the dashboard to verify relevance before wiring search into your storefront. Use the same call shape from your code.

Step 4

Search queries

As your front end starts calling search, every query lands here so you can see live activity and import historical logs.

Step 5

docs.veryquery.com

Full reference for every endpoint, request shape, and response field.

The Intelligence map starts being useful once you have a few weeks of queries flowing. Billing covers the four tiers, what each plan includes, and how the catalog cap is enforced.

One thing that applies to both

Search results depend on the catalog being indexed and ingested cleanly. If something looks off in Search Lab, the first place to look is the item's processing state on the Items page. The second is the selectivity dial on Search Lab, which loosens or tightens how borderline matches are treated.