Using Array Functions in Workflows

Array Functions handle array data in workflows.

An array is a list of data. In workflows, arrays commonly appear as lists of objects, such as order line items.

Array Functions can:

Array Functions are premium actions and may incur charges per execution.

The Select Field dropdown is where you choose the array that the action should process.

For example, if the workflow uses Shopify order data, you may select Line Items as the array field.

After an Array Functions action runs, Kyrios creates output values that can be used later in the workflow.

Use the custom values picker to insert Array Functions output into another workflow action.

The Find action returns the first object in an array that matches a key-value condition.

Use Find when you only need one matching item.

Example: Find whether a specific product ID exists in Shopify line items.

Find returns one object only. If multiple objects match, Kyrios returns the first matching object.

The Find by index action returns one item based on its position in the array.

Array positions start at 0.

Example:

Use Find by index when the item’s position is known.

The Filter action returns all objects in an array that match one or more filter conditions.

Use Filter when you need multiple matching items.

A filter condition includes a key and a value.

Example: Filter line items where the id matches a specific user, product, or dynamic workflow value.

The Line Items action rebuilds an array into a custom structure.

Use Line Items when another action needs data in a specific format, such as:

Line Items takes an input array and outputs a new array using the fields you define.

The Math Functions action runs calculations on numeric values inside an array.

Use Math Functions to calculate values such as total price, minimum price, maximum price, average price, or item count.

Available math operations:

The workflow may not have array data available yet. Use a trigger or action that provides array data, such as Shopify data, an inbound webhook, or a custom webhook response.

The key or value may not match any item in the array. Check the exact key name, value format, and dynamic value used in the action.

This is expected behavior. Use Filter if you need all matching items instead of the first matching item.

Array index positions start at 0, not 1. The first item is index 0.

Array Functions work with arrays, which are lists of objects or numbers. Arrays commonly come from Shopify triggers, inbound webhooks, and custom webhook response data.

Yes. Array Functions are premium workflow actions and may incur charges when they run.

No. Array Functions are designed for flat arrays. Nested data may require custom handling.

Yes. You can use multiple Array Functions in the same workflow and use the output from one action in later actions.

Use Test Workflow and review the action output. Confirm that the selected array, key, value, and action type are correct.