Documentation

Storefront widget

The reviews widget displays approved reviews on your product pages with star ratings, reviewer name, date, and any attached photos. It also shows an aggregate star rating and a “Write a review” button that links to your review form page.

• Add the Anton Reviews widget block to your product template via the Shopify theme editor
• Set the accent colour in block settings to match your brand
• Only approved reviews are shown publicly — pending and rejected reviews are never visible
• Reviews with photos show thumbnails that open full-size on click
• The Write a review button links to /pages/write-a-review?product_id=...&product_title=...

Review form page

The review form lives on a dedicated Shopify page (/pages/write-a-review) rather than inline on product pages. This keeps product pages fast and gives the form enough space for photo uploads and the star picker.

• Create the page in Shopify admin: Online Store → Pages → Add page, slug: write-a-review
• In the theme editor, open the page template and add the Anton Review Form app block
• Customers who are not logged in are shown a login prompt with a return URL
• When accessed via a review request email token, no login is required
• Rating (1–5 stars), optional title, and review body (10–2000 characters) are required

Photo uploads

Customers can attach up to 3 photos per review. Photos are selected from the device before submitting — they are not uploaded until the form is submitted. iPhone HEIC photos are fully supported.

Photos are automatically converted to WebP and resized to a maximum of 1920×1920px. Processing happens server-side so large HEIC files from iPhone cameras work without any browser limitations.

• Accepted formats: JPEG, PNG, WebP, HEIC/HEIF
• Maximum file size per photo: 20 MB (raw before processing)
• Maximum 3 photos per review
• Minimum photo dimensions: 200×200px after processing
• Storage is counted against your plan's image storage allowance
• Pro+ plans: uploaded photos are checked by AI to confirm they show a genuine product
• Photos can be removed from the dashboard — storage is reclaimed immediately

Dashboard

The Reviews section of the Anton dashboard has three tabs:

• Queue — reviews awaiting moderation. Approve, reject, or flag each review. Flagged reviews stay visible to you but are hidden from the storefront.
• All Reviews — every review with filters for approved / rejected / flagged. Expand any review to see the full text, attached photos, reply thread, and verification status.
• Request Log — a history of every review request email sent, with the order ID, customer, number of products, and how many have been reviewed so far.

From the expanded review detail you can write a reply that appears publicly below the review, remove individual photos, and re-moderate a review at any time.

The Settings panel (gear icon) lets you configure auto-approve, the daily submission rate limit per customer, and whether unverified purchasers can submit reviews on the direct path.

Earning points

The Earn Rules tab controls how customers accumulate points. Each rule can be toggled and configured independently. The points currency name (e.g. "coins", "stars") is set in the Config tab.

• Purchase — earn X points per € spent. The main earn rule, always available.
• Account creation — one-time welcome bonus when a customer creates an account.
• Birthday — annual bonus awarded on the customer's birthday (requires birthday data collected at sign-up).
• Product review — bonus points when a customer submits a review (Pro plan).
• Social follow — bonus points for following on social media (Pro plan).
• Max redemption % — caps how much of an order value can be covered by points (e.g. 50% max).

Rewards

The Rewards tab is where you create the options customers can redeem their points for. Each reward generates a real Shopify discount code at the moment of redemption — points are only deducted after the code is successfully created.

• Percentage discount — e.g. 10% off for 500 points.
• Fixed amount discount — e.g. €5 off for 300 points.
• Free shipping — removes shipping cost for a set number of points.
• Free product — generates a 100% discount code for a specific product.
• Each reward has a name, points cost, and can be enabled or disabled at any time.
• Redemption is atomic — if Shopify fails to generate the code, points are automatically returned.

Storefront widget

Two theme blocks are available in the Anton app extension:

• Loyalty Account — add to your customer account page. Shows balance, recent activity, available rewards, and a redeem button that displays the discount code inline.
• Earn Widget — add to product pages. Fetches the points preview for the product price and shows 'Earn X points on this purchase' to logged-in customers.
• Both blocks pull live data from Anton's API and require no manual configuration beyond adding them in the Shopify theme editor.

Ledger & manual adjustments

The Ledger tab lets you look up any customer by email, view their full transaction history, and make manual point adjustments with a reason note. All manual adjustments are logged with your user ID for audit purposes.

Setup: COGS & fees

Before profit numbers are accurate, you need to configure two things in Profit → Configure COGS & fees:

• Product costs (COGS) — cost prices for your products or variants. Import via CSV or add manually. Without these, gross margin will show as 100%.
• VAT rate — applied to extract VAT from order totals (default: 21%). Set to 0 if your store sells VAT-exclusive.
• Transaction fee % + fixed — your payment processor's per-transaction cost (e.g. 2% + €0.30 for Stripe).
• Avg shipping cost override — if your actual shipping cost differs from what Shopify records, override it here.

Anton resolves costs using a three-tier fallback for every order line item:

1. Variant cost — exact cost set for that specific variant. Takes priority.
2. Product cost — a single cost set for the whole product. Applies to any variant that doesn't have its own entry. Ideal when all variants share the same cost.
3. Default cost % — a store-wide fallback expressed as a percentage of the line item's revenue (e.g. 40%). Used for products with no individual cost configured. Set it in the Settings tab.

If none of these apply, Anton records the line as having no COGS data, which will show up in the COGS coverage indicator on the dashboard.

CSV format for bulk COGS import:

variant_id,product_id,product_title,variant_title,cost_price
44001000001,8800000001,Linen Throw Blanket,Sage,28.00
44001000002,8800000001,Linen Throw Blanket,Sand,28.00
,8800000002,Ceramic Mug Set × 4,,18.50

Leave variant_id blank to create a product-level cost (applies to all variants of that product). Set a variant_id to create a variant-level override. At least one of variant_id or product_id must be present per row.

The product_title and variant_title columns are optional labels — Anton will look them up from Shopify if omitted. Variant and product IDs can be found in Shopify admin under Products → select product → Variants, or via the Shopify API.

Dashboard

The main Profit page shows your store's performance for the selected period with:

• KPI cards — Revenue, Net Profit, Average Margin %, and Order Count, each with % change vs the previous equivalent period.
• Revenue vs Net Profit chart — daily line chart so you can spot dips and trends.
• Top products by profit — ranked by net profit, showing revenue, margin, and units sold.
• Alerts — highlights negative-margin products and variants missing COGS data.
• COGS coverage indicator — shows what percentage of line items have a cost price. Below 80% the dashboard flags it.

Use the period buttons (7 days, 30 days, 90 days, This month, Last month) to switch time ranges. Data is cached for 15 minutes — click Refresh to force a fresh pull from Shopify.

Ask Anton

The Anton Buddy chat widget (bottom-right on every dashboard page) automatically understands profit-related questions. When you ask about margins, COGS, revenue, or product profitability, Anton silently fetches your last 30 days of profit data in the background and answers with full context — no separate panel or setup required.

• Ask things like: 'Which product is dragging my margin down?', 'What was my net profit last month?', 'Are any products losing money?'
• Profit context is only fetched when the question is profit-related — other questions are answered normally without the extra data load.
• Requires profit_analytics to be available on your plan. If it isn't, Anton will let you know.
• Conversation history is kept within the session so you can follow up naturally.

Weekly digest

Enable the Weekly Profit Digest in Profit Settings to receive an AI-generated profit summary by email each week. The digest covers the past 7 days — top products, margin trends, and any alerts — and is sent on your chosen day of the week.

Setup

No setup is required beyond having a connected Shopify store. Optionally, configure defaults in Auto SEO → Settings:

• Overwrite existing content by default — pre-fills the overwrite checkboxes in the generation modal. You can still change it per product.

Generating content

Open Auto SEO from the sidebar. The product table shows all your Shopify products with three status indicators per row:

• Description — whether the product has a body description.
• SEO Title — whether a meta title tag is set (global.title_tag metafield).
• Meta — whether a meta description tag is set (global.description_tag metafield).

Click Generate on any product row to open the generation modal. If existing content is present, you will see checkboxes to overwrite it — unchecking means Anton skips writing that field, leaving the existing content untouched. Empty fields are always written.

After generating, the modal shows a preview of what was written. Changes are live in Shopify immediately — no publish step needed. The product row's status badges update automatically.

• Description: 80–150 words, HTML formatted (<p>, <ul>, <li>, <strong>), benefit-focused.
• SEO title: max 60 characters, includes the product name and a key attribute or benefit.
• Meta description: max 160 characters, compelling and unique, ends with a soft CTA.
• Language is auto-detected from the product title — no manual setting needed.
• Each generation uses roughly 300–500 tokens in + 300–400 tokens out (Haiku model).

Use the History tab to see all past generations — product, date, what was overwritten, and token count.

Setup

Open Smart Restock → Settings to configure the engine:

• Lookback days — the sales window used to calculate daily velocity (default: 30 days).
• Lead time — how many days it takes your supplier to fulfil an order (default: 14 days).
• Safety buffer — extra days of stock on top of lead time to guard against delays (default: 7 days).
• Critical threshold — items with fewer than this many days of stock are flagged Critical (default: 14 days).
• Minimum margin % — items below this margin are excluded from recommendations (useful for low-margin or loss-leader products).

Reading recommendations

The main table shows one row per tracked variant. Each row includes current stock, daily sales velocity, estimated days of stock remaining, and the recommended reorder quantity. The reorder quantity covers your lead time plus safety buffer at current velocity, rounded up to the nearest 5 units.

• Use the urgency tabs (All / Critical / Warning / OK / No Sales) to filter the list.
• Search by product or variant name to quickly find a specific item.
• Expand any row to see the AI note — a short contextual comment on the top 10 critical or warning items.
• Snapshot data is cached for 6 hours. Click Refresh to force a fresh calculation from Shopify.
• No Sales items are variants with zero velocity in the lookback window — they may be seasonal or discontinued.

Setup

Open Auto Bundles → Settings to configure analysis parameters:

• Lookback days — order history window for co-purchase analysis (default: 90 days).
• Min co-purchase count — a pair must appear together at least this many times (default: 3).
• Min co-purchase % — a pair must represent at least this % of either product's orders (default: 5%).
• Default bundle size — 2 for pairs, 3 for triplets (default: 2).
• Default discount % — percentage discount applied when activating a bundle (default: 10%).

Click Run Analysis to trigger a fresh scan. Analysis is rate-limited to once per 24 hours to avoid hammering the Shopify API. A minimum of 50 orders is required for reliable results.

Activating bundles

Each suggestion card shows the products included, confidence score, co-purchase frequency, AI-generated title and description, and a pricing summary. The Suggestions tab shows pending bundles awaiting your decision. The Active tab shows live bundles.

• Click Activate to create the bundle in Shopify. If your store has the Shopify Bundles app installed, a native bundle is created. Otherwise, Anton creates a regular product with a BUNDLE prefix and a component metafield.
• You can edit the title, description, and discount before activating.
• Click Dismiss to remove a suggestion without creating a bundle.
• Active bundles can be deactivated at any time — this archives the product in Shopify.
• You can also create bundles manually by entering Shopify product IDs directly, bypassing the AI suggestion flow.

Managing events

The calendar displays a standard Monday-first monthly grid. Events are colour-coded by type:

• Sale — red. Discount periods, flash sales, clearance events.
• Seasonal — amber. Holiday seasons, annual shopping moments (Black Friday, Christmas, etc.).
• Product launch — indigo. New product releases or collection drops.
• Local event — green. Markets, pop-ups, offline activations.
• Other — grey. Anything that doesn't fit the above.

Click any empty day to create a new event. Click an existing event chip to edit or delete it. Events can span multiple days — use the date range pickers to set start and end dates, or toggle the Single day switch for a one-day event. All events you create are marked as manual source and can be freely edited or deleted.

• Event names are limited to 100 characters.
• The upcoming events sidebar (visible on wide screens) shows the next 90 days of events sorted by start date.
• Navigate months using the chevron arrows at the top of the grid.

How it works

Campaign suggestions are generated from your Campaign Calendar events. Anton looks at the event name, type, and timing, then pulls in your live product catalogue to pick relevant items for each angle.

• Open Campaign Planner — pending suggestions for upcoming events appear automatically.
• Each suggestion contains 2–3 angles with different creative directions (e.g. 'Emotional storytelling', 'Urgency play', 'Behind the brand').
• If no suggestion exists for an event yet, Anton will generate one on demand.
• Suggestions are generated up to 14 days before the event by default.
• Requires: Campaign Calendar with at least one upcoming event.

Reviewing & sending

Click Review on any suggestion to open the detail panel.

• Select an angle — read the description, subject line, and featured products to pick the best fit.
• Preview the full email body. Toggle 'Customise email body' to edit the copy directly.
• Override the subject line — your edited version will be used instead of the AI-generated one.
• Send now — delivers immediately to your customer list via Klaviyo (if connected) or Resend.
• Schedule — pick a date and time, then click Schedule Send. The campaign will be queued and delivered automatically.
• Dismiss — removes the suggestion without sending. You can regenerate from the Campaign Calendar.

Shopify

Shopify is the core integration. Without it, no inventory or customer automations will function. The connection uses Shopify OAuth — Anton requests only the permissions it needs (products, inventory, customers, gift cards).

• Install the Anton app from the link in the Integrations page (one-time)
• Click Connect Shopify and approve the permissions in Shopify admin
• Once connected, your store domain will appear in the Integrations page
• Shopify cannot be disconnected from the dashboard — contact support if needed

Klaviyo

Klaviyo is used for sending customer-facing emails (restock notifications, etc.). You connect it using a Klaviyo Private API key.

• In Klaviyo: Settings → API keys → Create private API key (Full access or custom with Email, Lists, Profiles)
• Paste the key into the Klaviyo card in Integrations and click Connect
• Anton verifies the key against the Klaviyo API before saving
• You can disconnect and reconnect at any time

Custom domain

If your Shopify store uses a custom domain (e.g. yourstore.com instead of yourstore.myshopify.com), enter it here. Anton will use it in customer-facing links and gift card QR codes so URLs look clean and on-brand.

• Enter the domain without protocol — e.g. yourstore.be, not https://yourstore.be
• Once saved, all product links in emails and gift cards will use this domain