---
title: "How to Add a Wrike Table"
description: "Turn a TurboDocx variable into a table that the Wrike automation fills with a folder or project's sub-items, with optional nesting and filtering."
url: "https://docs.turbodocx.com/docs/Integrations/Wrike/table-variable"
---

# How to Add a Wrike Table

> Turn a TurboDocx variable into a table that the Wrike automation fills with a folder or project's sub-items, with optional nesting and filtering.

A **Wrike Table** variable turns a single template variable into a table. When the Wrike automation runs, TurboDocx fills that table with the triggering folder or project's **sub-items** (its tasks, and its subfolders or subprojects), one row each. You choose which Wrike fields become the columns, how the rows are laid out, whether nested sub-items are expanded, and an optional filter that limits which sub-items appear.

This is different from [Static Field Mapping](https://docs.turbodocx.com/docs/Integrations/Wrike/field-mapping.md), which maps one Wrike field to one variable. A Wrike Table maps one variable to many rows.

## Prerequisites

- A template uploaded to TurboDocx with at least one variable that is on its own line (a rich-text variable, so the generated table has room to render)
- A connected Wrike account (see [Setting Up a Wrike Automation](https://docs.turbodocx.com/docs/Integrations/Wrike/setting-up-automation.md))

## Configure the table

### Step 1: Open the variable menu

On your template's **Details** page, find the variable you want to turn into a table. On its input row, click the **three-dot menu** (the "..." button at the right of the row).

![Variable input row with the three-dot menu button highlighted](https://docs.turbodocx.com/img/wrike_table_filtering/01_variable_menu.png)

In the menu that opens, click **Wrike Table**. This opens the Wrike Table editor with a live preview.

![Variable menu open with the Wrike Table option highlighted](https://docs.turbodocx.com/img/wrike_table_filtering/02_select_wrike_table.png)

### Step 2: Add fields (columns)

Each field is a **value source** plus a **label**:

- **Value source**: the Wrike field whose value fills the cells (for example Title, Status, Due Date, Assignee, or any custom field).
- **Label**: type your own column heading, or pick a field and use its name as the heading.

Add as many fields as you need, and drag the handles to reorder them. To show each row's entity type (Task, Folder, or Project), add the built-in **Item Type** field as a column.

![Wrike Table builder with the + Add Field button highlighted](https://docs.turbodocx.com/img/wrike_table_filtering/06_add_fields.png)

### Step 3: Choose the layout

- **Sub-items as rows** (default): each sub-item is a row, each field is a column.
- **Sub-items as columns**: the table is transposed.

You can also pick an optional **Sub-item header** field (for example Title) to label each sub-item along the other axis, and set **Empty state text** that renders when the trigger has no sub-items.

![Options section with the Layout dropdown highlighted](https://docs.turbodocx.com/img/wrike_table_filtering/07_layout.png)

### Step 4: Expand nested sub-items (optional)

Turn on **Expand nested sub-items** to recurse beneath the direct children. **Max depth** controls how many nested levels are expanded (1 to 5). Each nested row is numbered hierarchically (1, 1.1, 1.1.1) and indented so the hierarchy reads cleanly. Nesting is available only in the rows layout.

![Expand nested sub-items toggle and the Max depth control highlighted](https://docs.turbodocx.com/img/wrike_table_filtering/08_nesting.png)

### Step 5: Filter which sub-items appear (optional)

Add a **Filter** to include only sub-items that match one or more conditions. Pick a field, then an operator and value. The available operators adapt to the field you pick:

- **Item Type**: "is any of" / "is none of", choosing from the built-in Task, Folder, and Project types plus your Wrike custom item types.
- **Date fields**: before, after, on, on or before, on or after, between, plus relative options (overdue, in the next N days, in the last N days).
- **Numeric fields** (currency, numeric, or percentage): is greater than, is greater than or equal to, is less than, is less than or equal to, is between, plus equals / not equals.
- **Other fields**: is set, is not set, is checked, is not checked, equals, not equals.

#### Combine multiple conditions

Click **+ Add condition** to add another row to the filter (up to 10). When you have two or more conditions, a **Match all (AND) / any (OR)** selector appears:

- **all (AND)**: a sub-item must satisfy *every* condition to appear.
- **any (OR)**: a sub-item appears if it satisfies *at least one* condition.

![Filter section with the Match all (AND) selector highlighted](https://docs.turbodocx.com/img/wrike_table_filtering/03_match_all_any.png)

![Match selector open showing the all (AND) and any (OR) options](https://docs.turbodocx.com/img/wrike_table_filtering/04_and_or_options.png)

Each condition has its own field, operator, and value, and the remove (trash) icon next to a condition deletes just that row. For example, to list only the **milestones due in the next 30 days**, add two conditions combined with **all (AND)**:

1. **Item Type** "is any of" **Milestone**
2. **Due date** "is in the next" **30** days

Milestone is a Wrike custom item type, so this condition needs a Wrike plan that includes custom item types (see [Notes and limits](#notes-and-limits) below). To exercise multiple conditions on any plan, use a built-in type instead, such as **Item Type** "is any of" **Folder** combined with a due-date condition.

The filter keeps a parent row whenever it, or any sub-item beneath it, matches the conditions.

When **Expand nested sub-items** is on, two extra options control how a match pulls in the rows around it:

- **Keep parent rows** (on by default): keeps the parent rows above a match, so a deeply nested match still reads in context. Turn this off to show only the matching rows themselves; a match whose parents are hidden moves up to the top level.
- **Include sub-items** (off by default): when a row matches, also show everything nested beneath it, even if those sub-items don't match the filter. Use this to filter the top of your hierarchy and then bring each matching branch in whole.

![The Add Condition button with the Keep parent rows and Include sub-items toggles below the conditions](https://docs.turbodocx.com/img/wrike_table_filtering/05_add_condition.png)

#### Numeric filter operators

When you pick a **numeric** field — a currency, numeric, or percentage field — the condition switches to number comparisons. Pick the field, then choose how to compare it and enter the number.

1. In a condition, open the **field** picker and choose a numeric field (currency, numeric, or percentage). The operator and value controls change to numeric ones automatically.

   ![A filter condition with a numeric currency field chosen, showing a numeric operator and value box](https://docs.turbodocx.com/img/wrike-table-numeric-filters/01_pick_numeric_field.png)

2. Open the **operator** list and choose one: *is greater than*, *is greater than or equal to*, *is less than*, *is less than or equal to*, *is between*, or *equals* / *does not equal*.

   ![The filter operator list open showing the numeric operators](https://docs.turbodocx.com/img/wrike-table-numeric-filters/02_numeric_operators.png)

3. Enter the number to compare against. **is between** shows two boxes — the low and high ends of the range.

   ![The is between operator with a low value and a high value entered](https://docs.turbodocx.com/img/wrike-table-numeric-filters/03_between_values.png)

:::tip Type a plain number
Enter numeric values as plain numbers — `50000`, not `$50,000.00`. TurboDocx compares the numbers directly, so you don't add the currency symbol, thousands separators, or decimals, and the result isn't affected by how the field is formatted in Wrike.
:::

### Step 6: Save

Click **Save** in the table builder to apply your configuration. That is the last step.
The template details page saves your variable as you go, so there is no separate
save action.

![Wrike Table builder with the Save button highlighted](https://docs.turbodocx.com/img/wrike_table_filtering/09_save.png)

## What happens at generation time

The table is built by the Wrike automation when a document is generated, so a Wrike Table variable is **read-only** on the generation page (it shows an informational banner instead of an input). There is nothing to fill in by hand. If you want to enter content manually instead, use **Switch to manual input** on the generation page.

## Notes and limits

- **Row cap**: a table renders at most 500 rows. If more sub-items qualify, the table shows the first 500 and notes how many were omitted.
- **Plan entitlements**: Wrike custom item types and finance fields (such as Budget or Actual Cost) require a Wrike plan that includes them. If your plan does not, those fields are left blank and a custom item-type filter condition is skipped (the table is never silently emptied). The built-in Task, Folder, and Project types work on any plan.

## Related

- [How to Add a Wrike Image](https://docs.turbodocx.com/docs/Integrations/Wrike/image-variable.md)
- [How to Setup Static Field Mapping](https://docs.turbodocx.com/docs/Integrations/Wrike/field-mapping.md)
- [Setting Up a Wrike Automation](https://docs.turbodocx.com/docs/Integrations/Wrike/setting-up-automation.md)
- [Troubleshooting and FAQ](https://docs.turbodocx.com/docs/Integrations/Wrike/troubleshooting.md)