> For the complete documentation index, see [llms.txt](https://docs.ecwid.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.ecwid.com/changelog/ecwid-api-changelog.md).

# Ecwid API Changelog

Keep track of changes and new features in Ecwid API.

### April 30, 2026

<table data-header-hidden><thead><tr><th width="531.203125"></th><th></th></tr></thead><tbody><tr><td><a data-mention href="/changelog/april-2026/april-30/tax-preview-generation.md">Tax preview generation</a></td><td><a data-mention href="https://docs.ecwid.com/storefronts/">Storefronts</a></td></tr><tr><td><a data-mention href="/changelog/april-2026/april-30/track-product-option-changes-on-the-storefront.md">Track product option changes on the storefront</a></td><td><a data-mention href="https://docs.ecwid.com/api-reference/">API Reference</a></td></tr><tr><td><a data-mention href="/changelog/april-2026/april-30/new-report-for-potential-leads-stats.md">New report for potential leads stats</a></td><td><a data-mention href="https://docs.ecwid.com/api-reference/">API Reference</a></td></tr><tr><td><a data-mention href="/changelog/april-2026/april-30/set-horizontal-spacing-between-product-cards.md">Set horizontal spacing between product cards</a></td><td><a data-mention href="https://docs.ecwid.com/api-reference/">API Reference</a></td></tr></tbody></table>

### February 24, 2026

<table data-header-hidden><thead><tr><th width="531.203125"></th><th></th></tr></thead><tbody><tr><td><a data-mention href="/changelog/february-2026/february-24/removed-script-requirement-for-generating-cart-urls.md">Removed script requirement for generating cart URLs</a></td><td><a data-mention href="https://docs.ecwid.com/storefronts/">Storefronts</a></td></tr><tr><td><a data-mention href="/changelog/february-2026/february-24/receive-product-data-in-response-to-put-post-calls.md">Receive product data in response to PUT/POST calls</a></td><td><a data-mention href="https://docs.ecwid.com/api-reference/">API Reference</a></td></tr><tr><td><a data-mention href="/changelog/february-2026/february-24/price-range-design-config.md">Price range design config</a></td><td><a data-mention href="https://docs.ecwid.com/api-reference/">API Reference</a></td></tr><tr><td><a data-mention href="/changelog/february-2026/february-24/features-available-on-current-plan.md">Features available on current plan</a></td><td><a data-mention href="https://docs.ecwid.com/api-reference/">API Reference</a></td></tr></tbody></table>

### January 25, 2026

<table data-header-hidden><thead><tr><th width="531.203125"></th><th></th></tr></thead><tbody><tr><td><a data-mention href="/changelog/january-2026/january-25/design-config-for-compact-products.md">Design config for compact products</a></td><td><a data-mention href="https://docs.ecwid.com/storefronts/">Storefronts</a></td></tr><tr><td><a data-mention href="/changelog/january-2026/january-25/new-store-vertical-settings.md">New store vertical settings</a></td><td><a data-mention href="https://docs.ecwid.com/api-reference/">API Reference</a></td></tr><tr><td><a data-mention href="/changelog/january-2026/january-25/discounted-shipping-rate-for-orders-and-carts.md">Discounted shipping rate for orders and carts</a></td><td><a data-mention href="https://docs.ecwid.com/api-reference/">API Reference</a></td></tr><tr><td><a data-mention href="/changelog/january-2026/january-25/timestamp-of-the-latest-change-for-product-options.md">Timestamp of the latest change for product options</a></td><td><a data-mention href="https://docs.ecwid.com/api-reference/">API Reference</a></td></tr></tbody></table>

### October 16, 2025

<table data-header-hidden><thead><tr><th width="531.203125"></th><th></th></tr></thead><tbody><tr><td><a data-mention href="/changelog/october-2025/october-16/composite-products-feature.md">Composite products feature</a></td><td><a data-mention href="https://docs.ecwid.com/api-reference/">API Reference</a></td></tr><tr><td><a data-mention href="/changelog/october-2025/october-16/new-site-activity-reports.md">New site activity reports</a></td><td><a data-mention href="https://docs.ecwid.com/api-reference/">API Reference</a></td></tr><tr><td><a data-mention href="/changelog/october-2025/october-16/default-product-sorting-for-one-page-catalog.md">Default product sorting for one-page catalog</a></td><td><a data-mention href="https://docs.ecwid.com/api-reference/">API Reference</a></td></tr><tr><td><a data-mention href="/changelog/october-2025/october-16/unused-js-api-call-removed.md">Unused JS API call removed</a></td><td><a data-mention href="https://docs.ecwid.com/storefronts/">Storefronts</a></td></tr></tbody></table>

### September 19, 2025

<table data-header-hidden><thead><tr><th width="531.203125"></th><th></th></tr></thead><tbody><tr><td><a data-mention href="/changelog/september-2025/september-19/store-id-is-now-required-for-external-apps-authentication.md">Store ID is now required for external apps' authentication</a></td><td><a data-mention href="https://docs.ecwid.com/">Build apps</a></td></tr><tr><td><a data-mention href="/changelog/september-2025/september-19/shipping-discount-data-in-order-details.md">Shipping discount data in order details</a></td><td><a data-mention href="https://docs.ecwid.com/api-reference/">API Reference</a></td></tr><tr><td><a data-mention href="/changelog/september-2025/september-19/tax-deduction-field-for-order-items.md">Tax deduction field for order items</a></td><td><a data-mention href="https://docs.ecwid.com/api-reference/">API Reference</a></td></tr><tr><td><a data-mention href="/changelog/september-2025/september-19/fixed-price-promotions.md">Fixed price promotions</a></td><td><a data-mention href="https://docs.ecwid.com/api-reference/">API Reference</a></td></tr></tbody></table>

### August 29, 2025

<table data-header-hidden><thead><tr><th width="531.203125"></th><th></th></tr></thead><tbody><tr><td><a data-mention href="/changelog/august-2025/august-29/design-config-for-the-all-products-storefront-mode.md">Design config for the All-products storefront mode</a></td><td><a data-mention href="https://docs.ecwid.com/storefronts/">Storefronts</a></td></tr><tr><td><a data-mention href="/changelog/august-2025/august-29/design-config-for-the-filters-orientation.md">Design config for the filters orientation</a></td><td><a data-mention href="https://docs.ecwid.com/storefronts/">Storefronts</a></td></tr><tr><td><a data-mention href="/changelog/august-2025/august-29/design-configs-for-product-swatches.md">Design configs for product swatches</a></td><td><a data-mention href="https://docs.ecwid.com/storefronts/">Storefronts</a></td></tr><tr><td><a data-mention href="/changelog/august-2025/august-29/composite-products-in-api.md">Composite products in API</a></td><td><a data-mention href="https://docs.ecwid.com/api-reference/">API Reference</a></td></tr></tbody></table>

### June 27, 2025

<table data-header-hidden><thead><tr><th width="531.203125"></th><th></th></tr></thead><tbody><tr><td><a data-mention href="/changelog/june-2025/june-27/trigger-promotions-with-any-product.md">Trigger promotions with any product</a></td><td><a data-mention href="https://docs.ecwid.com/api-reference/">API Reference</a></td></tr><tr><td><a data-mention href="/changelog/june-2025/june-27/external-id-for-customer-groups.md">External ID for customer groups</a></td><td><a data-mention href="https://docs.ecwid.com/api-reference/">API Reference</a></td></tr></tbody></table>

### June 13, 2025

<table data-header-hidden><thead><tr><th width="531.203125"></th><th></th></tr></thead><tbody><tr><td><a data-mention href="/changelog/june-2025/june-13/enable-custom-tips-with-a-store-profile-setting.md">Enable custom tips with a store profile setting</a></td><td><a data-mention href="https://docs.ecwid.com/api-reference/">API Reference</a></td></tr><tr><td><a data-mention href="/changelog/june-2025/june-13/new-report-type-visitors-activity-by-emails.md">New report type: visitors activity by emails</a></td><td><a data-mention href="https://docs.ecwid.com/api-reference/">API Reference</a></td></tr><tr><td><a data-mention href="/changelog/june-2025/june-13/error-codes-for-rest-api.md">Error codes for REST API</a></td><td><a data-mention href="https://docs.ecwid.com/api-reference/">API Reference</a></td></tr><tr><td><a data-mention href="/changelog/june-2025/june-13/create-and-update-combinations-with-product-calls.md">Create and update combinations with /product calls</a></td><td><a data-mention href="https://docs.ecwid.com/api-reference/">API Reference</a></td></tr></tbody></table>

### May 16, 2025

<table data-header-hidden><thead><tr><th width="531.203125"></th><th></th></tr></thead><tbody><tr><td><a data-mention href="/changelog/may-2025/may-16/get-recently-used-swatches-with-a-new-endpoint.md">Get recently used swatches with a new endpoint</a></td><td><a data-mention href="https://docs.ecwid.com/api-reference/">API Reference</a></td></tr><tr><td><a data-mention href="/changelog/may-2025/may-16/display-product-size-filters-as-buttons-grid.md">Display product size filters as buttons grid</a></td><td><a data-mention href="https://docs.ecwid.com/api-reference/">API Reference</a></td></tr><tr><td><a data-mention href="/changelog/may-2025/may-16/search-orders-by-the-payment-apps-client_id.md">Search orders by the payment app's client_id</a></td><td><a data-mention href="https://docs.ecwid.com/api-reference/">API Reference</a></td></tr></tbody></table>

{% hint style="warning" %}
**Breaking changes!**

Changes listed below will become backwards incompatible in the future. It's best to update payment applications now to ensure they continue working without any issues.&#x20;
{% endhint %}

<table data-header-hidden><thead><tr><th width="531.203125"></th><th></th></tr></thead><tbody><tr><td><a data-mention href="/changelog/may-2025/may-16/updated-encryption-mode-for-payment-api-requests.md">Updated encryption mode for payment API requests</a></td><td><a data-mention href="broken://spaces/bMnrDOrph8biE23TpY18">Broken link</a></td></tr></tbody></table>

### April 25, 2025

<table data-header-hidden><thead><tr><th width="531.203125"></th><th></th></tr></thead><tbody><tr><td><a data-mention href="/changelog/april-2025/april-25/schedule-for-automatic-promotions-enabling.md">Schedule for automatic promotions enabling</a></td><td><a data-mention href="https://docs.ecwid.com/api-reference/">API Reference</a></td></tr><tr><td><a data-mention href="/changelog/april-2025/april-25/delivery-pickup-precision-types.md">Delivery/pickup precision types</a></td><td><a data-mention href="https://docs.ecwid.com/api-reference/">API Reference</a></td></tr><tr><td><a data-mention href="/changelog/april-2025/april-25/size-limit-for-order-id-prefix-and-suffix.md">Size limit for Order ID prefix and suffix</a></td><td><a data-mention href="https://docs.ecwid.com/api-reference/">API Reference</a></td></tr></tbody></table>

### April 11, 2025

<table data-header-hidden><thead><tr><th width="531.203125"></th><th></th></tr></thead><tbody><tr><td><a data-mention href="/changelog/march-2025/march-28/new-endpoints-for-managing-customer-contacts.md">New endpoints for managing customer contacts</a></td><td><a data-mention href="https://docs.ecwid.com/webhook-automations/">Webhook automations</a></td></tr><tr><td><a data-mention href="/changelog/april-2025/april-11/bulk-update-product-reviews-with-a-new-endpoint.md">Bulk update product reviews with a new endpoint</a></td><td><a data-mention href="https://docs.ecwid.com/api-reference/">API Reference</a></td></tr><tr><td><a data-mention href="/changelog/april-2025/april-11/new-divider-element-for-building-custom-sections.md">New divider element for building custom sections</a></td><td><a data-mention href="https://docs.ecwid.com/site-themes/">Site Themes</a></td></tr></tbody></table>

### March 28, 2025

<table data-header-hidden><thead><tr><th width="531.203125"></th><th></th></tr></thead><tbody><tr><td><a data-mention href="/changelog/march-2025/march-28/new-endpoints-for-managing-customer-contacts.md">New endpoints for managing customer contacts</a></td><td><a href="https://docs.ecwid.com/api-reference/">API Reference</a></td></tr><tr><td><a data-mention href="/changelog/march-2025/march-28/color-swatches-as-product-options-in-ecwid-api.md">Color swatches as product options in Ecwid API</a></td><td><a href="https://docs.ecwid.com/api-reference/">API Reference</a></td></tr><tr><td><a data-mention href="/changelog/march-2025/march-28/new-fields-to-check-storefront-url-format.md">New fields to check storefront URL format</a></td><td><a href="https://docs.ecwid.com/api-reference/">API Reference</a></td></tr><tr><td><a data-mention href="/changelog/march-2025/march-28/new-details-in-the-ecwid.cart.get-method-from-js-api.md">New details in the Ecwid.Cart.get() method from JS API</a></td><td><a href="https://docs.ecwid.com/storefronts/">Storefronts</a></td></tr></tbody></table>

### March 25, 2025

New endpoints and search tools for customers in API reference.

<table data-header-hidden><thead><tr><th width="531.203125"></th><th></th></tr></thead><tbody><tr><td><a href="/changelog/march-2025/march-25/phone-and-address-as-query-params-for-searching-customers.md">Phone and address as query params for searching customers</a></td><td><a href="https://docs.ecwid.com/api-reference/">API Reference</a></td></tr><tr><td><a href="/changelog/march-2025/march-25/new-endpoints-for-customer-extra-fields.md">New endpoints for customer extra fields</a></td><td><a href="https://docs.ecwid.com/api-reference/">API Reference</a></td></tr></tbody></table>

### March 20, 2025

Check out the list of security changes released for Ecwid API in the last 6 months.&#x20;

These changes could break some apps, so we recommend going through the links below to ensure your application is updated or was not affected by the changes.

{% hint style="danger" %}
**Breaking changes!**\
Сhanges listed below may break some apps' logic.
{% endhint %}

<table data-header-hidden><thead><tr><th width="531.203125"></th><th></th></tr></thead><tbody><tr><td><a href="/changelog/march-2025/march-20/sha1-replaced-with-sha256-for-the-storefront-sso-feature.md">SHA1 replaced with SHA512 for the Storefront SSO feature</a></td><td><a href="https://docs.ecwid.com/api-reference/">API Reference</a></td></tr><tr><td><a href="/changelog/march-2025/march-20/discontinued-tokens-passing-in-query-params-of-api-calls.md">Discontinued tokens passing in query params of API calls</a></td><td><a href="https://docs.ecwid.com/api-reference/">API Reference</a></td></tr><tr><td><a href="/changelog/march-2025/march-20/new-returnurl-format-in-payment-api-with-enhanced-security.md">New returnUrl format in payment API with enhanced security</a></td><td><a href="broken://spaces/bMnrDOrph8biE23TpY18">Payment methods</a></td></tr><tr><td><a href="/changelog/march-2025/march-20/oauth-for-public-apps-get-request-type-changed-to-post.md">OAuth for public apps: GET request type changed to POST</a></td><td><a href="/launch-apps/public-apps-overview.md">Launch apps</a></td></tr></tbody></table>

### March 17, 2025

<table data-header-hidden><thead><tr><th width="531.203125"></th><th></th></tr></thead><tbody><tr><td><a href="/changelog/march-2025/march-17/expansion-of-allowed-http-codes-for-webhook-confirmation.md">Expansion of allowed HTTP codes for webhook confirmation</a></td><td><a href="https://docs.ecwid.com/webhook-automations/">Webhook automations</a></td></tr><tr><td><a href="/changelog/march-2025/march-17/new-conditions-for-promotions.md">New conditions for promotions</a></td><td><a href="https://docs.ecwid.com/api-reference/">API Reference</a></td></tr><tr><td><a href="/changelog/march-2025/march-17/new-query-params-for-the-search-categories-call.md">New query params for the "Search categories" call</a></td><td><a href="https://docs.ecwid.com/api-reference/">API Reference</a></td></tr></tbody></table>

{% hint style="danger" %}
**Breaking changes!**\
Сhanges listed below may break some apps' logic.
{% endhint %}

<table data-header-hidden><thead><tr><th width="531.203125"></th><th></th></tr></thead><tbody><tr><td><a href="/changelog/march-2025/march-17/new-and-updated-values-for-discount-bases-in-orders-and-carts.md">Updated list of discount bases in REST API</a></td><td><a href="https://docs.ecwid.com/api-reference/">API Reference</a></td></tr></tbody></table>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.ecwid.com/changelog/ecwid-api-changelog.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.