{"section":"announcements","requestedLocale":"en","requestedSlug":"2021-05-20-new-filtering-options-for-the-orders-feed-and-hook","locale":"en","slug":"2021-05-20-new-filtering-options-for-the-orders-feed-and-hook","path":"docs/en/announcements/2021/may/2021-05-20-new-filtering-options-for-the-orders-feed-and-hook.md","branch":"main","content":"We have improved the orders [feed and hook](https://developers.vtex.com/vtex-rest-api/docs/feed-v3-1) configuration options with a new type of filter which allows stores to get updates regarding any order attribute. For example, it is now possible to receive updates when an order is delivered or an item is changed, among other things.\n\n## What has changed?\n\nBefore, the feed and the hook tracked changes only in the orders’ [status](/en/docs/tutorials/order-flow-and-status#order-status-details).\n\nWith the new configuration, any changes made to orders can be tracked. This is done through [JSONata](https://jsonata.org/) expressions set in the Orders API, which allow for highly customized filtering.\n\n## Why did we make this change?\n\nOrder filtering by status did not include events that were relevant for some integration. We realized that stores could benefit from receiving updates when orders were delivered or had items changed, for example.\n\nFurthermore, this new configuration allows for a number of custom filter options in addition to the ones mentioned above. Since it uses [JSONata expressions](https://docs.jsonata.org/overview.html), you can combine filtering conditions and select specific subsets of orders that should generate events, for example.\n\n## What needs to be done?\n\nExisting feed and hook configurations are not affected by this change. This new configuration is an alternative to the default filtering by status.\n\nYou can implement the new configuration by using the [Feed v3 configuration](https://developers.vtex.com/vtex-rest-api/reference/feed-v3) or [Hook configuration](https://developers.vtex.com/vtex-rest-api/docs/feed-v3-1#hook) endpoints of the Order API. Learn more about how to configure this new filter in the [Feed v3 guide](https://developers.vtex.com/vtex-rest-api/docs/feed-v3-1).\n\nIf you need to test your JSONata filtering expressions, use our [JSONata expressions API endpoint](https://developers.vtex.com/vtex-rest-api/reference/feed-v3#testjsonataexpression)."}