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

# Changelog

> Product updates, fixes, and feature announcements

<Update label="June 18, 2026" tags={["Cart", "Checkout", "Orders", "Products"]}>
  ### Cart

  * The default cart service fee is now **0%** (previously 5%). New carts are created with no service fee unless you explicitly set one.

  ### Checkout

  * Checkout details now return a single, unified `data` result shape across methods - easier to parse and consistent regardless of the underlying merchant.
  * Added shipping cost estimation, so you can surface expected shipping before a purchase completes.
  * Faster checkout page load and clearer inline form validation messages.

  ### Orders

  * Completed order results may now return `null` for `tax` and `shipping` when a merchant doesn't itemize them, instead of failing validation.

  ### Merchant Coverage

  * Expanded supported merchants for product search and details, including UNIQLO, Gap, Banana Republic, Mango, Nike, DSW, and Fashion Nova.
</Update>

<Update label="April 22, 2026" description="v1.5.0" tags={["Cart"]}>
  ### Affiliate Product Links

  * Cart items now accept an optional `affiliateProductLink` field on `cart.create`, `cart.item.add`, and `cart.item.update`. Pass your partner tracking URL and Henry will use it for fulfillment while keeping the original `link` as the canonical product reference.
  * `affiliateProductLink` is also returned on purchase responses (`cart.checkout.pollPurchase`) and order list items, so you can reconcile attribution end-to-end.
  * If `affiliateProductLink` is omitted, Henry falls back to `link` - existing integrations are unaffected.
  * Available in [`@henrylabs/sdk@1.5.0`](https://www.npmjs.com/package/@henrylabs/sdk).
</Update>

<Update label="April 17, 2026" description="v1.4.0" tags={["Cart"]}>
  ### Cart Fetch

  * Added `cart.fetch(cartId, { buyer? })` to retrieve a single cart by ID and optionally prefill buyer details in the returned `checkoutUrl` for hosted checkout.
  * Available in [`@henrylabs/sdk@1.4.0`](https://www.npmjs.com/package/@henrylabs/sdk).
</Update>

<Update label="April 14, 2026" description="v1.3.0" tags={["Products", "Cart"]}>
  ### Product Discovery

  * `products.search` now supports merchant-scoped search via `type: 'merchant'`, alongside existing text and image search.
  * `mode: 'sync'` added across `products.search`, `products.details`, and `cart.checkout.purchase` - wait up to 30s for results inline instead of polling.

  ### Cart

  * `cart.create` settings now accept the full `settings.events` trigger model, including webhook, email, points, and tier actions with optional conditionals.
  * Released in [`@henrylabs/sdk@1.3.0`](https://www.npmjs.com/package/@henrylabs/sdk).
</Update>

<Update label="April 13, 2026" description="v1.2.1" tags={["SDK"]}>
  ### SDK

  * Published [`@henrylabs/sdk@1.2.1`](https://www.npmjs.com/package/@henrylabs/sdk) with method signature updates and polling helper refinements.
</Update>

<Update label="March 30, 2026" description="v1.1.2" tags={["SDK"]}>
  ### SDK

  * Published [`@henrylabs/sdk@1.1.2`](https://www.npmjs.com/package/@henrylabs/sdk) with refreshed generated types.
</Update>

<Update label="March 20, 2026" description="v1.0.0" tags={["SDK", "Client SDK"]}>
  ### Henry SDK v1

  * Shipped [`@henrylabs/sdk@1.0.0`](https://www.npmjs.com/package/@henrylabs/sdk) - the stable TypeScript server SDK for product discovery, universal cart, checkout, and orders.
  * Cart creation now returns a ready-to-use `checkoutUrl` alongside `cartId` - no separate session step needed.
  * Unified async pattern (`refId` + `poll*`) across product search, product details, and headless checkout, with a new `mode: 'sync'` option to wait up to 30s inline.

  ### Client SDK (Browser)

  * Introduced [`@henrylabs/js@1.0.0`](https://www.npmjs.com/package/@henrylabs/js) - a framework-agnostic browser SDK for embedding checkout directly into your frontend.
  * `Henry.createCheckoutElement(...)` drops a buy-now button and modal onto any page with display modes for full, compact, comfortable, bubble, and direct.
  * `Henry.createCardElement(...)` renders an isolated iframe for PCI-safe card capture and returns a `cardToken` for server-side use with headless checkout.
</Update>

<Update label="February 09, 2026" description="v0.25.0">
  ### MCP Improvements

  * Added initial server instructions for MCP.

  ### Bug Fixes

  * Fixed a memory leak related to abort signals in the client.
  * Fixed an issue where abort listeners were removed too early.
  * MCP no longer falls back to baseUrl when the environment variable is set.
  * Correctly defined the `false` enum type.
</Update>

<Update label="January 26, 2026" description="v0.24.0">
  ### Improvements

  * Merged staging into main.

  ### Bug Fixes

  * Fixed MCP installation instructions for remote servers.
  * MCP now allows fallback behavior for required environment variables.
</Update>

<Update label="January 12, 2026" description="v0.22.1" tags={["Products", "MCP"]}>
  ### Transaction Fee on Checkout

  * Charge users a transaction fee on checkout. This fee is applied to the total order amount. Currently for Enterprise customers only.

  ### Saved Shipping Addresses for Guest Users

  * Now guest users can save multiple shipping addresses

  ### Checkout MCP

  * Bug fixes and performance improvements
</Update>

<Update label="January 5, 2026" description="v0.22.0" tags={["Products"]}>
  ### Concurrent Enrich & Variant Check Requests

  * Enrich and check variants in parallel, with up to 50 concurrent requests.
  * Now possible to batch enrich and check variants

  ### Improved Product Search Filtering

  * Updated product text and image search parameters to include additional filters and sorting options.
  * Filter by brand, merchant, min/max price, sale status, and more.
  * Scope searches to country and region (Ex. us, Austin, Texas)
  * Sort results by relevance and price
</Update>

<Update label="December 29, 2025" description="v0.22.0" tags={["Cart", "Checkout", "Products"]}>
  ### Multi-Cart Checkouts

  * Checkout multiple items at once with our multi-cart checkout flow. Multi-cart checkout will work automatically without any code changes.
  * Users can add items to cart from any supported merchant, and they will be checked out together. Adding multiple items in a single request is currently experimental.

  ### Save Additional Addresses & Payment Methods

  * Save additional address and payment methods for your users, making it easier than ever to place orders.
  * This feature is released along side with a visual refresh of our hosted checkout page.

  ### Enrich Top-k Products

  * Now automatically enrich top-k products returned from Text Product and Image Product searches.
</Update>

<Update label="December 22, 2025" description="v0.21.1" tags={["Checkout", "Orders"]}>
  ### Custom Themes

  * In addition to adding your brand assets to emails and our hosted checkout page, you can now customize the color scheme of our checkout page and purchase confirmation email.

  ### Order Management

  * Query all orders for a given user using our new Order List endpoint
</Update>

<Update label="December 15, 2025" description="v0.18.0" tags={["Products", "Checkout", "Orders"]}>
  ### Product Discovery

  * Introducing reverse image search. Search through 2b+ SKUs, enabling more intuitive and visual shopping experiences in your app.

  ### Hosted Checkout

  * Added iFrame support with cookie-free checkout. Embed the checkout experience directly in your app without worrying about third-party cookie restrictions or cross-origin limitations.

  ### Programmatic Email Inbox

  * All transactional emails, order confirmations, shipping updates, newsletters, and more are now captured and stored.
  * Query and access your users' merchant emails programmatically, giving you full control to build custom order tracking, notifications, and support experiences.
</Update>

<Update label="December 8, 2025" description="v0.17.0" tags={["Checkout", "Products"]}>
  ### Global Region Support

  * Now, allow users from anywhere in the world to route checkouts through Henry Labs
  * Initial support is for EU and UK regions in addition to existing US support. Wider global support coming soon

  ### Product Enrichment Endpoints

  * Introduced Product Enrichment Endpoints, allowing you to get product price, variant information, stock availability for a product given its link
  * Endpoint is currently Experimental, with availability reserved for Plus Plan customers and above

  ### API Playground

  * Added new API Playground for Sandbox and Production environments. Get started [here](https://docs.henrylabs.ai/info/playground)
  * Intended for developers trying out our APIs. It's recommended to save the Directory link to keep your documentation up to date with our latest API changes
</Update>

<Update label="December 1, 2025" description="v0.15.0" tags={["Products"]}>
  ### Basic, Standard, and Plus Plans

  * Rolled out self-serve subscription plans for customers of all sizes.
  * No matter what stage your business is in, Henry Labs has a plan for you. Build embedded shopping experiences in your app today.

  ### AI Agent in Quickstart Demo

  * Added AI Agent to Quickstart Demo. Try it out [here](https://demo.henrylabs.ai/ai).
  * This agent is powered by [Henry Shopping MCP](https://www.npmjs.com/package/@henrylabs/mcp)
</Update>

<Update label="November 24, 2025" description="v0.14.0" tags={["Orders"]}>
  ### Enterprise Pro Plan

  * Introduced Enterprise Pro Plan, with full access to headless checkout, bespoke API features, 24/7 support, and more. For more information contact [support@henrylabs.ai](mailto:support@henrylabs.ai).

  ### Email Whitelabeling

  * Email domain whitelabeling has been rolled out in production. Route merchant emails through your own domain, allowing you to control the end-to-end customer experience without comprimising user trust or ever managing returns.
</Update>

<Update label="November 17, 2025" description="v0.13.0" tags={["Checkout", "Products", "Wallet"]}>
  ### Checkout & Payment Experience

  * Visual refresh. Updated payment card designs, icons, dropdowns, and more.
  * Improved UI for CVV updates, payment method management, and shipping address autocomplete.

  ### Product Search & Quickstart Demo

  * Expanded product details API to include reviews, video, stars, similar products, and related searches.
  * Quickstart Demo now renders new product details on `demo.henrylabs.ai`.

  ### Hosted Checkout Whitelabeling

  * Add your brand logo to the hosted checkout modal.
</Update>

<Update label="November 10, 2025" description="v0.12.0" tags={["Orders", "Checkout"]}>
  ### Henry Managed Accounts

  * Introducing Henry Managed Accounts. Unlock the power of user merchant accounts fully managed by Henry Labs.
  * Track post-order states (shipping, returns, etc) so you can provide your customers real-time order updates.
  * Whitelabel merchant emails, build trust with your customers, and have full control over the E2E user experience.
  * Managed accounts are rolling out to all supported merchants

  ### Hosted Checkout

  * Hosted checkout now supports updating CVV at point of checkout
</Update>

<Update label="November 3, 2025" description="v0.11.0" tags={["Products"]}>
  ### Product Discovery

  * The result of variant checks is now reflected in our Hosted Checkout page

  ### Henry Shopping SDK (TypeScript)

  * Introducing the Henry Shopping SDK, making it easier than ever to start building (Python SDK coming soon)

  ### Henry MCP Server

  * Add an end-to-end embedded commerce stack to your agent application with less than 10 lines of code
</Update>

<Update label="October 23, 2025" description="v0.10.0" tags={["Cart", "Wallet", "Products"]}>
  ### Universal Cart

  * `POST /cart/items` now accepts `affiliateProductLink`, letting you pass through your partner tracking links end-to-end.
  * Added the optional `checkVariantAvailability` parameter so carts can auto-check the selected variant's inventory when items are added. Feature is currently experimental.
  * Introduced a "blocklist" mode that allows any product to be added to cart and checked out except for those explicitly blocked.

  ### Wallet

  * Added guest card collection mode for `/wallet/cart-collect`

  ### Product Discovery

  * Released experiemental variant check endpoints. Use them to check real time stock availability of variants.

  ### Henry Dashboard

  * Added staging vs. production environment flag to dashboard.

  ### Miscellaneous

  * Added unified generated documentation at `api.[sandbox].henrylabs.ai/docs`
</Update>