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

# Changelog

> New features and improvements in the Depict platform for headless merchants and the Shopify theme app.

<Update label="August 2026" description="New portal">
  We are improving the portal **one area at a time**, and improvements reach
  stores in stages — so you may see something here before a colleague at another
  store does. Nothing you have set up changes: your settings, rules and data
  carry across untouched.

  When an improvement reaches you, the portal marks it with a dot in the
  navigation and shows a short note about what is different.

  ## Your dashboard at a glance

  Attributed revenue, conversion, average order value and orders across search
  and recommendations, each opening a daily trend for the period you pick. The
  action queue surfaces what needs you: searches returning nothing, slow movers
  with stock behind them, and collections getting traffic but no sales.

  ## Recommendations in one place

  Surfaces, rules and pinned products sit together, so setting up a placement
  takes fewer clicks and less hunting. Where recommendation analytics is on,
  each surface reports its own performance and every KPI tile opens a trend.

  ## Recommendation rules, easier to work with

  Each rule shows what it applies to, what it pins and what it hides without
  being opened, so a surface can be read top to bottom. Rules apply in order and
  drag to reorder. A search box filters them by the product or collection ID they
  reference, which is how you find the one rule touching a product among dozens.
  If a new rule contradicts an existing one for shoppers who match both, the
  conflict is shown with the ways to resolve it before anything is saved.

  ## Live preview for recommendations

  Pick a product and see the recommendations a shopper would get for it right
  now, with the products your rules pinned marked as such. Saved rule changes
  appear within a few minutes. Personalised surfaces need session data before
  they return anything, and a few surface types cannot be previewed.

  Pinned products that are out of stock in every market are flagged on the rule
  itself and counted on the surface, since a pin on an unavailable product is
  silently doing nothing.

  ## Search insights and settings together

  Your top queries, the searches that return nothing, and your search
  configuration now live on the same page — so you can spot a gap and fix it
  without changing screens. A funnel traces impressions through clicks,
  add-to-carts and orders.

  ## Boost and Bury, easier to work with

  Rules are easier to read and reorder, and you can see what each rule is doing
  to your listings before you save.

  ## A faster product catalog

  Browsing the whole catalog stays fast however large it is, filters and search
  are kept in the URL so a view can be shared, and the product drawer collects
  details, inventory and the collections a product belongs to in one place.

  ## Settings, easier to navigate

  Users, attributes, filters, markets, tracking and appearance are grouped in
  the sidebar instead of one long page, so each area has room to breathe.
</Update>

<Update label="August 2026" description="Collections">
  ## Collections, quicker to work in

  Collections now works the same way for every store, with:

  * Configurable product cards: density, product id, stock, engagement, sales
    and hover image, remembered per merchant
  * A list layout alongside the grid, with drag-to-reorder in both
  * Re-nesting, cover images and sub-collection creation from the list itself
  * Scroll position and expansion state preserved when you navigate back
  * Filters, search and sorting kept in the URL, so a view can be shared

  Collection metrics — views, CTR, revenue, sell-through — appear on the list
  for merchants with collection analytics enabled.
</Update>

<Update label="August 2026" description="Analytics areas">
  ## Search and recommendation analytics

  Analytics is switched on per area, so search and recommendation reporting can
  arrive separately from collection metrics.

  **Search analytics** adds KPI tiles to the Search overview, a funnel from
  impressions through clicks and add-to-carts to orders, per-query trends
  against the previous period, and decision-support metrics on the products and
  collections you pin in Start View.

  **Recommendation analytics** reports impressions, clicks, CTR, attributed
  revenue and add-to-carts for every surface, plus average order value,
  add-to-cart rate and purchase rate — so placements can be compared with each
  other rather than only counted.
</Update>

<Update label="August 2026" description="Collections">
  ## Favourite collections in the sidebar

  Star a collection and it appears in the sidebar, so the ones you work on
  daily are one click away from anywhere in the portal. Drag them to set your
  own order.
</Update>

<Update label="August 2026" description="Search">
  ## Start View for empty search

  Start View controls what shoppers see when they open search **before typing
  anything**: pin the products and collections you want to lead with, reorder
  them by dragging, and preview the result as a shopper would see it.

  * Suggestions drawn from what the empty search would return organically, so
    you can promote what is already working
  * Manual pickers for products and collections outside those suggestions
  * Decision-support metrics on every row (views, units sold, visitors,
    revenue) for merchants with search analytics enabled
  * Changes save automatically — there is no save button to forget
</Update>

<Update label="August 2026" description="Analytics">
  ## Export any analytics view to CSV

  Export the Analytics page for any period, choosing which blocks to include:
  overview KPIs, collection highlights, search KPIs, search queries and
  recommendation surfaces. One row per metric, with the previous period beside
  it, and the file names its own scope and contents so it still makes sense a
  month later. Blocks that could not be loaded are recorded in the file rather
  than silently missing.

  ## Recommendation performance per surface

  Each recommendation surface now reports average order value, add-to-cart rate
  and purchase rate alongside impressions, clicks, CTR and attributed revenue —
  so you can compare placements rather than just totals.

  ## Search funnel and click cut-off

  The search funnel traces impressions to clicks to add-to-carts to orders for
  the selected market and period. On collections, the click cut-off names how
  far down the listing shoppers reach before 95% of clicks are accounted for.
</Update>

<Update label="July 2026" description="Documentation">
  ## Shopify theme app docs folded into Headless

  The full Shopify theme app documentation now lives under **Headless → Storefront integration (Shopify theme app)**. Old `/shopify-guide/` URLs redirect automatically. Release notes for the Shopify theme app appear in this changelog going forward.
</Update>

<Update label="July 2026" description="Analytics hub">
  ## Merchant-wide Analytics page

  A new top-level **Analytics** page aggregates performance across your whole
  store:

  * Store-wide KPIs: revenue, views, average CTR, units sold, add-to-carts and
    dead stock risk
  * A merchant-wide conversion funnel from impressions to purchases
  * Search insights: top queries and zero-result queries per market
  * Collection highlights: top collections by revenue, declining collections,
    and a pinned-vs-auto health rollup

  ## Collection analytics improvements

  * **Pinned vs Auto** recommendations: plain-language verdicts (pins
    performing / check pins / unpin advised) with per-product breakdowns and
    one-click pin/unpin
  * **Add-to-cart tracking** integrated into collection metrics and the
    conversion funnel
  * **Variant availability** as a real inventory metric
  * **Benchmarking**: compare collections against each other and against the
    all-collections baseline
  * **Dead stock** and stock coverage per collection, with a searchable,
    CSV-exportable dead stock list
  * Metric tooltips explaining CTR, STR, RPM and friends wherever they appear
</Update>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.