# Ecwid API Changelog

### 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="april-2026/april-30/tax-preview-generation">tax-preview-generation</a></td><td><a data-mention href="https://app.gitbook.com/o/7RBnM4uFCrMwAT24ojPQ/s/aRJpOy0U8IpbjUfcox4D/">Storefronts</a></td></tr><tr><td><a data-mention href="april-2026/april-30/track-product-option-changes-on-the-storefront">track-product-option-changes-on-the-storefront</a></td><td><a data-mention href="https://app.gitbook.com/o/7RBnM4uFCrMwAT24ojPQ/s/G9n5VxMY9T0Ob3D56PSD/">API Reference</a></td></tr><tr><td><a data-mention href="april-2026/april-30/new-report-for-potential-leads-stats">new-report-for-potential-leads-stats</a></td><td><a data-mention href="https://app.gitbook.com/o/7RBnM4uFCrMwAT24ojPQ/s/G9n5VxMY9T0Ob3D56PSD/">API Reference</a></td></tr><tr><td><a data-mention href="april-2026/april-30/set-horizontal-spacing-between-product-cards">set-horizontal-spacing-between-product-cards</a></td><td><a data-mention href="https://app.gitbook.com/o/7RBnM4uFCrMwAT24ojPQ/s/G9n5VxMY9T0Ob3D56PSD/">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="february-2026/february-24/removed-script-requirement-for-generating-cart-urls">removed-script-requirement-for-generating-cart-urls</a></td><td><a data-mention href="https://app.gitbook.com/o/7RBnM4uFCrMwAT24ojPQ/s/aRJpOy0U8IpbjUfcox4D/">Storefronts</a></td></tr><tr><td><a data-mention href="february-2026/february-24/receive-product-data-in-response-to-put-post-calls">receive-product-data-in-response-to-put-post-calls</a></td><td><a data-mention href="https://app.gitbook.com/o/7RBnM4uFCrMwAT24ojPQ/s/G9n5VxMY9T0Ob3D56PSD/">API Reference</a></td></tr><tr><td><a data-mention href="february-2026/february-24/price-range-design-config">price-range-design-config</a></td><td><a data-mention href="https://app.gitbook.com/o/7RBnM4uFCrMwAT24ojPQ/s/G9n5VxMY9T0Ob3D56PSD/">API Reference</a></td></tr><tr><td><a data-mention href="february-2026/february-24/features-available-on-current-plan">features-available-on-current-plan</a></td><td><a data-mention href="https://app.gitbook.com/o/7RBnM4uFCrMwAT24ojPQ/s/G9n5VxMY9T0Ob3D56PSD/">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="january-2026/january-25/design-config-for-compact-products">design-config-for-compact-products</a></td><td><a data-mention href="https://app.gitbook.com/o/7RBnM4uFCrMwAT24ojPQ/s/aRJpOy0U8IpbjUfcox4D/">Storefronts</a></td></tr><tr><td><a data-mention href="january-2026/january-25/new-store-vertical-settings">new-store-vertical-settings</a></td><td><a data-mention href="https://app.gitbook.com/o/7RBnM4uFCrMwAT24ojPQ/s/G9n5VxMY9T0Ob3D56PSD/">API Reference</a></td></tr><tr><td><a data-mention href="january-2026/january-25/discounted-shipping-rate-for-orders-and-carts">discounted-shipping-rate-for-orders-and-carts</a></td><td><a data-mention href="https://app.gitbook.com/o/7RBnM4uFCrMwAT24ojPQ/s/G9n5VxMY9T0Ob3D56PSD/">API Reference</a></td></tr><tr><td><a data-mention href="january-2026/january-25/timestamp-of-the-latest-change-for-product-options">timestamp-of-the-latest-change-for-product-options</a></td><td><a data-mention href="https://app.gitbook.com/o/7RBnM4uFCrMwAT24ojPQ/s/G9n5VxMY9T0Ob3D56PSD/">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="october-2025/october-16/composite-products-feature">composite-products-feature</a></td><td><a data-mention href="https://app.gitbook.com/o/7RBnM4uFCrMwAT24ojPQ/s/G9n5VxMY9T0Ob3D56PSD/">API Reference</a></td></tr><tr><td><a data-mention href="october-2025/october-16/new-site-activity-reports">new-site-activity-reports</a></td><td><a data-mention href="https://app.gitbook.com/o/7RBnM4uFCrMwAT24ojPQ/s/G9n5VxMY9T0Ob3D56PSD/">API Reference</a></td></tr><tr><td><a data-mention href="october-2025/october-16/default-product-sorting-for-one-page-catalog">default-product-sorting-for-one-page-catalog</a></td><td><a data-mention href="https://app.gitbook.com/o/7RBnM4uFCrMwAT24ojPQ/s/G9n5VxMY9T0Ob3D56PSD/">API Reference</a></td></tr><tr><td><a data-mention href="october-2025/october-16/unused-js-api-call-removed">unused-js-api-call-removed</a></td><td><a data-mention href="https://app.gitbook.com/o/7RBnM4uFCrMwAT24ojPQ/s/aRJpOy0U8IpbjUfcox4D/">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="september-2025/september-19/store-id-is-now-required-for-external-apps-authentication">store-id-is-now-required-for-external-apps-authentication</a></td><td><a data-mention href="https://app.gitbook.com/o/7RBnM4uFCrMwAT24ojPQ/s/uOzT5egoVTAjMJwRuMQT/">Build apps</a></td></tr><tr><td><a data-mention href="september-2025/september-19/shipping-discount-data-in-order-details">shipping-discount-data-in-order-details</a></td><td><a data-mention href="https://app.gitbook.com/o/7RBnM4uFCrMwAT24ojPQ/s/G9n5VxMY9T0Ob3D56PSD/">API Reference</a></td></tr><tr><td><a data-mention href="september-2025/september-19/tax-deduction-field-for-order-items">tax-deduction-field-for-order-items</a></td><td><a data-mention href="https://app.gitbook.com/o/7RBnM4uFCrMwAT24ojPQ/s/G9n5VxMY9T0Ob3D56PSD/">API Reference</a></td></tr><tr><td><a data-mention href="september-2025/september-19/fixed-price-promotions">fixed-price-promotions</a></td><td><a data-mention href="https://app.gitbook.com/o/7RBnM4uFCrMwAT24ojPQ/s/G9n5VxMY9T0Ob3D56PSD/">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="august-2025/august-29/design-config-for-the-all-products-storefront-mode">design-config-for-the-all-products-storefront-mode</a></td><td><a data-mention href="https://app.gitbook.com/o/7RBnM4uFCrMwAT24ojPQ/s/aRJpOy0U8IpbjUfcox4D/">Storefronts</a></td></tr><tr><td><a data-mention href="august-2025/august-29/design-config-for-the-filters-orientation">design-config-for-the-filters-orientation</a></td><td><a data-mention href="https://app.gitbook.com/o/7RBnM4uFCrMwAT24ojPQ/s/aRJpOy0U8IpbjUfcox4D/">Storefronts</a></td></tr><tr><td><a data-mention href="august-2025/august-29/design-configs-for-product-swatches">design-configs-for-product-swatches</a></td><td><a data-mention href="https://app.gitbook.com/o/7RBnM4uFCrMwAT24ojPQ/s/aRJpOy0U8IpbjUfcox4D/">Storefronts</a></td></tr><tr><td><a data-mention href="august-2025/august-29/composite-products-in-api">composite-products-in-api</a></td><td><a data-mention href="https://app.gitbook.com/o/7RBnM4uFCrMwAT24ojPQ/s/G9n5VxMY9T0Ob3D56PSD/">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="june-2025/june-27/trigger-promotions-with-any-product">trigger-promotions-with-any-product</a></td><td><a data-mention href="https://app.gitbook.com/o/7RBnM4uFCrMwAT24ojPQ/s/G9n5VxMY9T0Ob3D56PSD/">API Reference</a></td></tr><tr><td><a data-mention href="june-2025/june-27/external-id-for-customer-groups">external-id-for-customer-groups</a></td><td><a data-mention href="https://app.gitbook.com/o/7RBnM4uFCrMwAT24ojPQ/s/G9n5VxMY9T0Ob3D56PSD/">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="june-2025/june-13/enable-custom-tips-with-a-store-profile-setting">enable-custom-tips-with-a-store-profile-setting</a></td><td><a data-mention href="https://app.gitbook.com/o/7RBnM4uFCrMwAT24ojPQ/s/G9n5VxMY9T0Ob3D56PSD/">API Reference</a></td></tr><tr><td><a data-mention href="june-2025/june-13/new-report-type-visitors-activity-by-emails">new-report-type-visitors-activity-by-emails</a></td><td><a data-mention href="https://app.gitbook.com/o/7RBnM4uFCrMwAT24ojPQ/s/G9n5VxMY9T0Ob3D56PSD/">API Reference</a></td></tr><tr><td><a data-mention href="june-2025/june-13/error-codes-for-rest-api">error-codes-for-rest-api</a></td><td><a data-mention href="https://app.gitbook.com/o/7RBnM4uFCrMwAT24ojPQ/s/G9n5VxMY9T0Ob3D56PSD/">API Reference</a></td></tr><tr><td><a data-mention href="june-2025/june-13/create-and-update-combinations-with-product-calls">create-and-update-combinations-with-product-calls</a></td><td><a data-mention href="https://app.gitbook.com/o/7RBnM4uFCrMwAT24ojPQ/s/G9n5VxMY9T0Ob3D56PSD/">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="may-2025/may-16/get-recently-used-swatches-with-a-new-endpoint">get-recently-used-swatches-with-a-new-endpoint</a></td><td><a data-mention href="https://app.gitbook.com/o/7RBnM4uFCrMwAT24ojPQ/s/G9n5VxMY9T0Ob3D56PSD/">API Reference</a></td></tr><tr><td><a data-mention href="may-2025/may-16/display-product-size-filters-as-buttons-grid">display-product-size-filters-as-buttons-grid</a></td><td><a data-mention href="https://app.gitbook.com/o/7RBnM4uFCrMwAT24ojPQ/s/G9n5VxMY9T0Ob3D56PSD/">API Reference</a></td></tr><tr><td><a data-mention href="may-2025/may-16/search-orders-by-the-payment-apps-client_id">search-orders-by-the-payment-apps-client_id</a></td><td><a data-mention href="https://app.gitbook.com/o/7RBnM4uFCrMwAT24ojPQ/s/G9n5VxMY9T0Ob3D56PSD/">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="may-2025/may-16/updated-encryption-mode-for-payment-api-requests">updated-encryption-mode-for-payment-api-requests</a></td><td><a data-mention href="broken-reference">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="april-2025/april-25/schedule-for-automatic-promotions-enabling">schedule-for-automatic-promotions-enabling</a></td><td><a data-mention href="https://app.gitbook.com/o/7RBnM4uFCrMwAT24ojPQ/s/G9n5VxMY9T0Ob3D56PSD/">API Reference</a></td></tr><tr><td><a data-mention href="april-2025/april-25/delivery-pickup-precision-types">delivery-pickup-precision-types</a></td><td><a data-mention href="https://app.gitbook.com/o/7RBnM4uFCrMwAT24ojPQ/s/G9n5VxMY9T0Ob3D56PSD/">API Reference</a></td></tr><tr><td><a data-mention href="april-2025/april-25/size-limit-for-order-id-prefix-and-suffix">size-limit-for-order-id-prefix-and-suffix</a></td><td><a data-mention href="https://app.gitbook.com/o/7RBnM4uFCrMwAT24ojPQ/s/G9n5VxMY9T0Ob3D56PSD/">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="march-2025/march-28/new-endpoints-for-managing-customer-contacts">new-endpoints-for-managing-customer-contacts</a></td><td><a data-mention href="https://app.gitbook.com/o/7RBnM4uFCrMwAT24ojPQ/s/Q47kAA1WxNIuWGKG5OiB/">Webhook automations</a></td></tr><tr><td><a data-mention href="april-2025/april-11/bulk-update-product-reviews-with-a-new-endpoint">bulk-update-product-reviews-with-a-new-endpoint</a></td><td><a data-mention href="https://app.gitbook.com/o/7RBnM4uFCrMwAT24ojPQ/s/G9n5VxMY9T0Ob3D56PSD/">API Reference</a></td></tr><tr><td><a data-mention href="april-2025/april-11/new-divider-element-for-building-custom-sections">new-divider-element-for-building-custom-sections</a></td><td><a data-mention href="https://app.gitbook.com/o/7RBnM4uFCrMwAT24ojPQ/s/kP7oeJaJ4GqXzYswT5rn/">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="march-2025/march-28/new-endpoints-for-managing-customer-contacts">new-endpoints-for-managing-customer-contacts</a></td><td><a href="https://app.gitbook.com/o/7RBnM4uFCrMwAT24ojPQ/s/G9n5VxMY9T0Ob3D56PSD/">API Reference</a></td></tr><tr><td><a data-mention href="march-2025/march-28/color-swatches-as-product-options-in-ecwid-api">color-swatches-as-product-options-in-ecwid-api</a></td><td><a href="https://app.gitbook.com/o/7RBnM4uFCrMwAT24ojPQ/s/G9n5VxMY9T0Ob3D56PSD/">API Reference</a></td></tr><tr><td><a data-mention href="march-2025/march-28/new-fields-to-check-storefront-url-format">new-fields-to-check-storefront-url-format</a></td><td><a href="https://app.gitbook.com/o/7RBnM4uFCrMwAT24ojPQ/s/G9n5VxMY9T0Ob3D56PSD/">API Reference</a></td></tr><tr><td><a data-mention href="march-2025/march-28/new-details-in-the-ecwid.cart.get-method-from-js-api">new-details-in-the-ecwid.cart.get-method-from-js-api</a></td><td><a href="https://app.gitbook.com/o/7RBnM4uFCrMwAT24ojPQ/s/aRJpOy0U8IpbjUfcox4D/">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="march-2025/march-25/phone-and-address-as-query-params-for-searching-customers">Phone and address as query params for searching customers</a></td><td><a href="https://app.gitbook.com/o/7RBnM4uFCrMwAT24ojPQ/s/G9n5VxMY9T0Ob3D56PSD/">API Reference</a></td></tr><tr><td><a href="march-2025/march-25/new-endpoints-for-customer-extra-fields">New endpoints for customer extra fields</a></td><td><a href="https://app.gitbook.com/o/7RBnM4uFCrMwAT24ojPQ/s/G9n5VxMY9T0Ob3D56PSD/">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="march-2025/march-20/sha1-replaced-with-sha256-for-the-storefront-sso-feature">SHA1 replaced with SHA512 for the Storefront SSO feature</a></td><td><a href="https://app.gitbook.com/o/7RBnM4uFCrMwAT24ojPQ/s/G9n5VxMY9T0Ob3D56PSD/">API Reference</a></td></tr><tr><td><a href="march-2025/march-20/discontinued-tokens-passing-in-query-params-of-api-calls">Discontinued tokens passing in query params of API calls</a></td><td><a href="https://app.gitbook.com/o/7RBnM4uFCrMwAT24ojPQ/s/G9n5VxMY9T0Ob3D56PSD/">API Reference</a></td></tr><tr><td><a href="march-2025/march-20/new-returnurl-format-in-payment-api-with-enhanced-security">New returnUrl format in payment API with enhanced security</a></td><td><a href="broken-reference">Payment methods</a></td></tr><tr><td><a href="march-2025/march-20/oauth-for-public-apps-get-request-type-changed-to-post">OAuth for public apps: GET request type changed to POST</a></td><td><a href="https://app.gitbook.com/s/uOzT5egoVTAjMJwRuMQT/launch-apps">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="march-2025/march-17/expansion-of-allowed-http-codes-for-webhook-confirmation">Expansion of allowed HTTP codes for webhook confirmation</a></td><td><a href="https://app.gitbook.com/o/7RBnM4uFCrMwAT24ojPQ/s/Q47kAA1WxNIuWGKG5OiB/">Webhook automations</a></td></tr><tr><td><a href="march-2025/march-17/new-conditions-for-promotions">New conditions for promotions</a></td><td><a href="https://app.gitbook.com/o/7RBnM4uFCrMwAT24ojPQ/s/G9n5VxMY9T0Ob3D56PSD/">API Reference</a></td></tr><tr><td><a href="march-2025/march-17/new-query-params-for-the-search-categories-call">New query params for the "Search categories" call</a></td><td><a href="https://app.gitbook.com/o/7RBnM4uFCrMwAT24ojPQ/s/G9n5VxMY9T0Ob3D56PSD/">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="march-2025/march-17/new-and-updated-values-for-discount-bases-in-orders-and-carts">Updated list of discount bases in REST API</a></td><td><a href="https://app.gitbook.com/o/7RBnM4uFCrMwAT24ojPQ/s/G9n5VxMY9T0Ob3D56PSD/">API Reference</a></td></tr></tbody></table>


---

# Agent Instructions: 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:

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

The question should be specific, self-contained, and written in natural language.
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.