Skip to content

Data Table Filter Rows

Keep or remove rows in a Data Table based on a condition test.

Parameters

Parameter Description
Data Table Source Select the target DataTable. Set Source, then assign the matching table, asset, or component field that appears.
Data Definition Optional fallback definition used when the resolved DataTable is not available in the editor.
Mode Choose whether matching rows are Keep Rows or Remove Rows.
Where The condition test used to match rows.
Affected Rows Output. Number of rows removed by the filter.
Changed Output. True if any rows were removed.

⚙ Details

  • If Data Table Source is not set or cannot be resolved, the action does nothing.
  • If the resolved DataTable is not available in the editor, assign Data Definition so the row fields in Where can be configured.
  • Where is evaluated for each row.
  • Keep Rows removes rows that do not match the condition.
  • Remove Rows removes rows that do match the condition.
  • Affected Rows starts at 0 and Changed starts at false before filtering runs.
  • Filtering can fail if the table cannot be modified, and the action logs the error.

Examples

  • Keep only inventory rows where Equipped is true.
  • Remove all quest rows where Completed is true.
  • Keep only shop items where Category equals Consumable.