Skip to main content
The Sort step takes a JSON array and reorders its items based on one or more fields. Use it to rank search results by relevance score, order invoices by date, or arrange products by price before passing the list to a model or returning it to the user. You can sort by multiple fields (primary, secondary, etc.), choose between numeric and alphabetical ordering, and control where null values land in the result.

​
Configuration

1

Input

An expression that resolves to a JSON array — for example, {{Steps.Search_Results.Value}}.
2

Sort criteria

One or more sort rules applied in order. The first criterion is the primary sort; subsequent criteria break ties.Each criterion has:
  • Field path — dot-notation path to the field (e.g., score, created.date). Leave empty to sort by the item value itself (useful for arrays of strings or numbers).
  • Direction — Ascending (A→Z, 0→9) or Descending (Z→A, 9→0).
  • Comparison type — Lexicographic (string/dictionary order) or Numeric (parse as number).
  • Case sensitive — toggle for lexicographic comparisons (off by default).
3

Null handling

Where to place items whose sort field is null or missing.
4

Missing field behavior

What to do when an item does not have the field at all.

​
Sort criteria in detail

​
Comparison types

If you choose Numeric and any item has a non-numeric value in the sort field, the step throws a runtime error. Use a Filter step first to remove items with invalid values, or use Lexicographic mode and accept string ordering.

​
Multi-field sorting

Add multiple criteria to handle ties. Criteria are applied in order — the first field is the primary sort, the second breaks ties in the first, and so on. Example: Sort employees by department (ascending), then by salary (descending) within each department: The sort is stable — items that are equal on all criteria keep their original relative order.

​
Null handling

Controls where items with null sort values appear in the result.

​
Missing field behavior

Controls what happens when an item does not have the sort field at all (the field is absent, not just null).

​
Output

The step returns a JSON array with the same items, reordered according to your criteria.
If the input is empty, the output is an empty array [].

​
Use case: rank knowledge base results for a RAG agent

A retrieval-augmented generation (RAG) agent searches a knowledge base and receives results with relevance scores. Before passing them to the model, you want the most relevant results first — and you want to drop any results where the score is missing. Agent flow:
Sort configuration: Sort criteria: What happens at runtime: Given this input from the knowledge base:
The Sort step returns:
  • The Blog entry is dropped because its score is null and null handling is set to Ignore.
  • The remaining items are ordered highest score first.
  • The AI Model step receives the most relevant documents at the top of its context.

​
Tips

Pair Sort with a Filter step upstream to first remove irrelevant items, then sort the remainder. This reduces the data the model needs to process and keeps token costs predictable.
For date sorting, use Lexicographic mode on ISO 8601 formatted dates (e.g., 2026-03-26T14:30:00Z). ISO 8601 strings sort correctly in lexicographic order because they are structured from most significant (year) to least significant (second).
The sort is stable — when two items are equal on all sort criteria, they appear in the same relative order as in the input. This is useful when you add a secondary sort and want tied items to keep their original sequence.