Azure EventGrid Namespace topic array filtering

Dat Tran 0 Microsoft Employee

Does Azure EventGrid Namespace topics have advanced filters to search arrays inside of the data object?

This documentation seems to indicate so, but the ARM documentations do not show it.

https://learn.microsoft.com/en-us/azure/event-grid/namespace-event-filtering

https://learn.microsoft.com/en-us/azure/templates/microsoft.eventgrid/namespaces/topics/eventsubscriptions?pivots=deployment-language-bicep#filter

Locked Question. You can vote on whether it's helpful, but you can't add comments or replies or follow the question.

Christos Panagiotidis 3,551 Reputation points

2026-07-29T10:43:58.6333333+00:00

Event Grid Namespace event subscriptions can apply advanced filters to primitive arrays in the event data. Set enableAdvancedFilteringOnArrays to true in the subscription filter, then use a dotted key such as data.tags with the appropriate string or numeric operator. Event Grid evaluates the array elements against the filter values.

This support is limited to arrays of primitive strings, numbers, or Boolean values. It cannot search properties inside an array of objects—for example, filtering data.items[].name is not supported. If your payload uses that structure, change the publisher schema to expose the required values as a separate primitive array or scalar property and filter that field instead. Ensure the deployment uses a current Event Grid API version containing the array-filter property; an older ARM schema may omit it even though the service supports it. After deployment, inspect the event subscription resource to confirm that advanced array filtering remained enabled and test both matching and nonmatching sample events.