Help
Getting started
How do I connect my store?
Shopify: install Avery from Shopify. Shopify shows you the permissions Avery asks for, you approve them, and Avery opens inside your Shopify admin already connected. Nothing is typed.
Everything else: sign up on our site with your email (we send you a sign-in link; there is no password), then on Set up connect a WordPress or WooCommerce site with the Avery plugin, or Wix, Webflow, Squarespace, Framer and any other site by pasting one snippet (Set up offers an Avery app for Wix and Webflow where one is available).
Either way the first analysis starts by itself, and results appear in a few minutes.
What does Avery read from my store?
Product catalogue metadata (titles, prices, images), your live theme files (Liquid and CSS), your pages, each order’s total and refunds (added up into daily orders and revenue — never who bought or where it shipped), visitor movement from its own pixel, and public page speed via Google PageSpeed Insights. The full list is in our privacy policy.
Does Avery change anything on my store?
As little as it can, and nothing shoppers see without you. On Shopify, connecting installs a small pixel that counts visits and purchases, which is how Avery can tell whether a change helped. Avery never edits your theme’s code. Its fixes are lines in Avery’s own blocks (a shipping, returns, trust, recent-sales or low-stock line) that you place once on your product page in Shopify’s theme editor. A block shows nothing until you approve what it says, and a change a block cannot make comes as short steps for the theme editor instead.
On WordPress and WooCommerce, the Avery plugin makes each change you approve, after you have seen it on a private preview link. Your theme and pages are never edited. On Wix, Webflow and other sites, Avery only reads, checks and measures: there are no fixes for those yet.
Can I undo a change?
Yes, from Avery, at any time. On Shopify, undo switches the block’s line off, and it is gone from your page on the next load; you can also remove the block in the theme editor. On WordPress, undo switches the change off through the plugin, and the plugin’s own settings page can switch it off too, even when Avery is unreachable. Undo is held while changes are paused for the store.
Avery also undoes a change by itself if your conversion rate falls clearly after it, but only once it is counting your visits and purchases on both sides of the change: on Shopify through its pixel, on WooCommerce through the Avery plugin from version 0.4.0. Until then it shows you the reading and leaves the decision to you.
Can I stop the weekly email?
Yes. Every digest has an unsubscribe link, and there is a switch in Settings. The same switch also stops the email that tells you a connection has broken; the dashboard still shows it. Billing emails are always sent, and so is the email telling you Avery has undone a change on your store, because that is about something Avery did to it.
Troubleshooting
“We couldn’t verify that response came from Shopify”
This means the sign-in attempt expired. It happens if you leave the Shopify consent screen open for a long time. Just try connecting again — each attempt uses a fresh token.
My analysis finished but shows no findings
There are a few possibilities:
- Your store is well-optimised. If the analysis ran successfully and found nothing, that is a real result — not every store has issues our rules can detect.
- The check was only partly successful. Open “What the last check covered” on your dashboard. If some sources failed (especially page speed), the result is incomplete rather than clean. Run the analysis again.
- Your store is password-protected. Shopify dev stores and pre-launch stores are behind a storefront password. Avery cannot read a password-protected storefront, and its rules refuse to report findings on pages they could not fully access — rather than producing false results.
Analysis keeps failing on some sources
If your dashboard shows a “Some checks are not getting through” warning:
- PageSpeed failures are usually temporary — Google’s API has rate limits. Try again in a few minutes.
- Snapshot or baseline failures mean Avery cannot reach your store through its API. This usually means the access has expired or been revoked. Click “Reconnect this store” on the dashboard; on WooCommerce, reconnect with new API keys.
- Storefront failures mean Avery could not read your public pages. Check that your store is not password-protected and is accessible from the internet.
I want to disconnect or delete my data
Go to Settings. You can disconnect your store (revokes the access token immediately) or delete all data (immediate and irreversible). Full details in our privacy policy.
Understanding findings
What does the confidence level mean?
- High — strong evidence: a controlled experiment of our own found a clear result, or we saw it happen on your site.
- Medium — supported by published research with a documented method, by an experiment that pointed the same way without being conclusive, or by one of ours that found a clear result on a different kind of site. Findings from our AI analysis are never rated higher than medium, because the AI judges that your store resembles what was tested, and that judgement is the unchecked link.
- Low — not proven. Either we could not trace the idea to a solid source, or the research is sound but what we could measure on your site is a weaker sign, such as page speed from Google’s simulated test rather than from your visitors. Treat these as ideas worth trying if they are cheap, not conclusions.
What is the impact score?
Impact combines three things: how severe the issue is, how strong the evidence is, and how much effort the fix requires. A high-severity issue with low confidence scores lower than a medium-severity issue with high confidence — this is deliberate. Unproven claims should not outrank measured ones.
Every finding says what it rests on — why?
Because “best practice” without evidence is opinion. Each finding names the experiment or research behind it and how firmly that evidence holds, so you can decide what to act on first. We don’t quote the numbers: a result measured on someone else’s site does not carry over to yours as a figure.
Checkout funnel
What is the checkout funnel?
The funnel breaks Shopify’s checkout into five sub-steps: contact info, address, shipping, payment, and order placed. Most analytics tools collapse these into one “checkout” step, which hides where visitors actually drop off. The funnel page shows you which step loses the most people.
Why does the funnel say “Still gathering data”?
The funnel needs real shopper sessions to report on, and it starts collecting only after the behaviour pixel is installed. It takes at least 30 sessions before the numbers are meaningful — anything less is as likely to be chance as a real pattern. The progress bar shows how close you are.
What are excluded events?
Events from visitors who did not grant consent are excluded from the funnel. The numbers you see reflect only consented sessions, so they undercount your traffic, sometimes by a lot behind a strict cookie banner, but never include people who opted out.
Why are very short visits missing?
On sites that aren’t on Shopify, Avery waits about five seconds after a page starts loading before it counts a visit, in case the site shows a cookie banner that should ask the visitor first. Visits shorter than about five seconds aren’t counted. The wait runs from when the page starts loading, not from when it finishes, so a page getting a little faster or slower doesn’t change which visits are counted.
Your own events
How do I count something Avery can’t see by itself?
On a site that runs Avery’s measurement snippet (anything not on Shopify, including WordPress with the Avery plugin), add one line of code where the thing happens:
window.avery.track("newsletter_signup", { list: "weekly", position: "footer" });The Events page then shows how many times it was sent and in how many visits. On Shopify, switch on “Avery shopper insights” first (Online Store → Themes → Customize → App embeds).
What are the rules?
- Names are up to 64 letters, numbers, underscores, dots, colons or dashes. Use one name per kind of thing and put the detail in the data:
add_to_wishlistwith a product, not one name per product. - Don’t use Shopify’s event names (such as
page_viewedorcheckout_completed) or names startingavery:; those are counted as something else. - Never send anything a shopper typed or anything that identifies them. Properties called
email,phone,address, or ending inname(soproductNametoo) are removed before anything is stored. - Avery keeps each event for 90 days, and a daily summary for as long as your site is connected. Common values of a property are listed only when at least three different visitors sent them, and never ones that look like an email address, a phone number, a web address or a name.
Multiple stores
How do I add a second store?
On your dashboard, press “+ Add a site” and connect it the way you connected the first. The second store joins your existing account, so you can switch between them with the store menu at the top of the dashboard without signing out. If you use Avery inside your Shopify admin, add another Shopify store by installing Avery from that store’s admin.
What if my second store is already connected elsewhere?
A store can belong to one Avery account at a time. If someone else connected it, you will see “That store is already connected to a different Avery account.” Sign out, then connect the store on its own to use it under a separate account.
The AI developer
How does the AI developer work?
On a finding Avery can fix, it writes the fix for your site, and nothing is applied until you approve it. On WordPress it writes the change and shows it to you on a private preview link. On Shopify it writes the words for an Avery block (a shipping or trust line, for example), with every fact quoted from your own store or from what you tell it; it never writes theme code, and it never invents an offer, a price or a policy. Where it has nothing to quote, it asks you.
What if I change my theme or my pages?
On WordPress, the plugin notices when a change no longer fits the page (the page was edited, or the theme switched) and Avery shows it as not showing rather than counting it as live. On Shopify, Avery reads your live theme on every analysis and says whether each block is still placed; if you switch themes, place it again.
Contact
Email us at hello@useavery.ai. You are talking to the people building the product — there is no support queue between you and a fix.