> ## Documentation Index
> Fetch the complete documentation index at: https://partner-integrations.voyado.com/llms.txt
> Use this file to discover all available pages before exploring further.

# What's new?

Here you'll find  the changes and updates to the Voyado Engage app for Shopify.

There is an RSS feed for this page allowing you to subscribe to changes as they are published.

<Card title="Show me the RSS feed" href="/docs/ecom/shopify/whats-new/rss.xml" icon="https://mintcdn.com/voyado-partners/0IxEIB2Y6a--gNYY/icons/partner-integrations-link.png?fit=max&auto=format&n=0IxEIB2Y6a--gNYY&q=85&s=f3f7d94d9be6a06ca87acc84e4d5c032" horizontal width="128" height="128" data-path="icons/partner-integrations-link.png" />

<Update label="2025-07-14">
  ## App disabled when invalid API key used

  With this update, the app automatically disables itself when it encounters an invalid or deleted API key. To resume syncing, merchants need to reconnect the app with a valid API key. Previously, if a customer's API key was revoked (for example, after they churn), the app would remain active and would need to be manually uninstalled.

  ## Skip customers without email in POS orders

  POS orders that include a customer who doesn't have an email address are now filtered out, preventing errors.

  ## Improved handling of refunds for unfulfilled orders

  Previously, syncing a refund for an order that had not yet reached the specified receipt-sync stage would cause the error: “Cannot handle refund due to related order not being synced.” This has now been addressed, aligning refund behavior with the expected syncing logic, which is:

  * If receipt-sync stage is set to "Fulfilled" the app ignores the refund until the order is fully fulfilled
  * If receipt-sync stage is set to "Unfulfilled" the app syncs the refund immediately

  ## Fallback store optional in store-to-country mapping

  A customer without a specific Engage store will now sync. The “Recruited in store” field will be left empty instead of blocking the sync. Previously, if a customer's country wasn't mapped to a store in Engage, and no fallback store was configured, the app would return a validation error.

  <Tip>
    If no fallback store is set, orders from unmapped countries won't sync. Be sure to map all shipping countries or else define a fallback store to avoid missing data.
  </Tip>
</Update>

<Update label="2025-03-31">
  ## Shopify app now uses GraphQL

  GraphQL is a flexible and modern way to retrieve data from an API, allowing faster syncing and smaller data loads. You will need to go into Shopify and update your Voyado Engage app before April 1st to avoid any issues.

  <Card title="Read about the update to GraphQL" href="https://knowledge.voyado.com/action-needed-update-your-voyado-app-for-shopify" icon="right" horizontal />
</Update>

<Update label="2025-03-17">
  ## New UI extensions

  The app's POS UI extensions were upgraded to Shopify's new Unified UI Extension Package, improving performance and maintainability, and giving access to the latest Shopify extension features.

  <Card title="Read more about the Unified UI Extension Package" href="https://shopify.dev/docs/api/pos-ui-extensions/2024-10/migrating" icon="right" horizontal />

  ## Admin action extension

  The existing admin link has been migrated to an Admin Action Extension for a more integrated experience within Shopify Admin.

  <Card title="See more on admin action extensions" href="https://shopify.dev/docs/apps/build/admin/actions-blocks/build-admin-action?extension=react" icon="right" horizontal />

  ## Script tag upgrade

  Shopify is moving away from script tags, requiring users to move from the `checkout_complete` event to the Web Pixel API's `checkout_completed` event. The `cr` parameter sent to Engage has also been adjusted to exclude the`key` attribute from the cartToken, ensuring consistency across all pixel events.

  <Card title="See more on the script tag changes" href="https://shopify.dev/docs/api/admin-graphql/2024-10/queries/scripttag" icon="right" horizontal />
</Update>

<Update label="2024-11-01">
  ## New lang attribute

  Added instructions for updating contacts to use the new `lang` attribute.

  <Card title="See about the lang attribute here" href="https://developer.voyado.com/docs/contacts/contact-field-definitions#language-lang" icon="https://mintcdn.com/voyado-partners/0IxEIB2Y6a--gNYY/icons/developer-link.png?fit=max&auto=format&n=0IxEIB2Y6a--gNYY&q=85&s=36f1df27b0269657d842f3301d440083" horizontal width="128" height="128" data-path="icons/developer-link.png" />
</Update>

<Update label="2024-10-17">
  ## Handling of zero-value refunds

  Added handling of refunds with an amount of 0.

  <Card title="See more about syncing receipts" href="/docs/ecom/shopify/using-the-app#syncing-receipts-to-engage" icon="https://mintcdn.com/voyado-partners/0IxEIB2Y6a--gNYY/icons/partner-integrations-link.png?fit=max&auto=format&n=0IxEIB2Y6a--gNYY&q=85&s=f3f7d94d9be6a06ca87acc84e4d5c032" horizontal width="128" height="128" data-path="icons/partner-integrations-link.png" />
</Update>

<Update label="2024-06-28">
  ## Web pixel tracking update

  Web pixel tracking now allows identification in checkout by email.

  <Card title="See more about web pixel tracking" href="/docs/ecom/shopify/identify-in-checkout-by-email" icon="https://mintcdn.com/voyado-partners/0IxEIB2Y6a--gNYY/icons/partner-integrations-link.png?fit=max&auto=format&n=0IxEIB2Y6a--gNYY&q=85&s=f3f7d94d9be6a06ca87acc84e4d5c032" horizontal width="128" height="128" data-path="icons/partner-integrations-link.png" />
</Update>

<Update label="2024-01-23">
  ## Task monitoring overview

  Task monitoring overview page and config panel added.

  <Card title="See more about task monitoring overview" href="/docs/ecom/shopify/task-monitoring-overview" icon="https://mintcdn.com/voyado-partners/0IxEIB2Y6a--gNYY/icons/partner-integrations-link.png?fit=max&auto=format&n=0IxEIB2Y6a--gNYY&q=85&s=f3f7d94d9be6a06ca87acc84e4d5c032" horizontal width="128" height="128" data-path="icons/partner-integrations-link.png" />
</Update>

<Update label="2024-01-09">
  ## Setup and configuration additions

  New sections were added to the setup and configuration guide:

  * Headless API keys
  * Synchronize marketing preferences
  * Synchronize marketing preference changes from Shopify orders

  <Card title="See the setup and configuration guide" href="/docs/ecom/shopify/configuration-guide" icon="https://mintcdn.com/voyado-partners/0IxEIB2Y6a--gNYY/icons/partner-integrations-link.png?fit=max&auto=format&n=0IxEIB2Y6a--gNYY&q=85&s=f3f7d94d9be6a06ca87acc84e4d5c032" horizontal width="128" height="128" data-path="icons/partner-integrations-link.png" />
</Update>

<Update label="2023-12-07">
  ## Headless loyalty API

  Headless loyalty API added, for displaying loyalty information without using the Shopify front-end.

  <Card title="Read about the loyalty API" href="/docs/ecom/shopify/loyalty-api" icon="https://mintcdn.com/voyado-partners/0IxEIB2Y6a--gNYY/icons/partner-integrations-link.png?fit=max&auto=format&n=0IxEIB2Y6a--gNYY&q=85&s=f3f7d94d9be6a06ca87acc84e4d5c032" horizontal width="128" height="128" data-path="icons/partner-integrations-link.png" />
</Update>

<Update label="2023-12-01">
  ## Shopify POS integration

  Shopify POS integration moved out of beta.

  ## UI update

  New UI released for the Voyado Engage app.
</Update>

<Update label="2023-10-16">
  ## Shopify POS integration

  The Shopify POS integration was released.

  <Card title="See Shopify POS articles" href="/docs/pos/shopify" icon="https://mintcdn.com/voyado-partners/0IxEIB2Y6a--gNYY/icons/partner-integrations-link.png?fit=max&auto=format&n=0IxEIB2Y6a--gNYY&q=85&s=f3f7d94d9be6a06ca87acc84e4d5c032" horizontal width="128" height="128" data-path="icons/partner-integrations-link.png" />
</Update>

<Update label="2023-10-05">
  ## PARTIALLY\_FULFILLED state

  Transactional state PARTIALLY\_FULFILLED was added.

  ## Abandoned browse

  Abandoned browse now works out-of-the-box.
</Update>

<Update label="2023-09-28">
  ## Change in handling of receipt number

  Receipt number in Engage is now connected to `order.name` from Shopify instead of `order.number`.

  <Tip>
    This will not affect already imported orders. Merchants with already imported orders should use the search term “Contains” when segmenting in Engage on specific order number or receipt numbers.
  </Tip>

  <Tip>
    Some merchants may not be affected by this at all since order number and order name can be the same in Shopify. The main change then is a suffix added to the number. Example: "12345" becomes "12345VOY".
  </Tip>

  ## Cancelled order update

  A cancelled order no longer triggers a refund email.
</Update>

<Update label="2023-09-13">
  ## Migration of orders

  Added migration of orders for customers who were imported to Engage outside of the Shopify app. For example, through a CSV file import in Engage.

  ## Consents handled correctly in checkout

  The "Accepts email" flag / consent in Engage is now updated correctly when completing checkout in Shopify.

  ## Validation mismatch fixed

  The validation mismatch on orders within the app has now been resolved. Previously, order totals did not match those in Shopify and were therefore not imported.

  ## Error handling improvement

  Better error handling of error message *409 - ContactWithKeyIsBeingCreated*.

  ## Fix for zero-discount entries

  When syncing orders, any zero-discount entries will now not be sent to Engage.
</Update>

<Update label="2023-08-15">
  ## Products of interest

  Products of interest now sent to Engage.

  ## Migration added

  Migration of customers and orders added.
</Update>

<Update label="2023-07-01">
  ## Assigning of vouchers and promotions

  Assigning vouchers and promotions in Engage for use in Shopify.
</Update>

<Update label="2023-06-01">
  ## Abandoned cart added

  Triggering of abandoned cart actions in Engage.
</Update>

<Update label="2023-01-27">
  ## Contacts sync

  Sync of contacts between Engage and Shopify.

  ## Transactional communication

  Transactional communication now sent out from Engage.

  ## Orders sent

  Orders (receipts), both purchase and return, sent to Engage.

  ## App theme block

  App theme block in Shopify showing customer's available vouchers and promotions.

  ## Redemption added

  Redeeming of promotions and vouchers.

  ## Soft identification added

  Soft identification (also called soft ID) added to app.
</Update>
