---
title: "Remove Item from List Step"
url: "https://docs.robotiq.ai/en/article/remove-item-from-list-step"
language: "en"
last_updated: "2025-12-24T14:48:50.869Z"
---

# Remove Item from List Step

The Remove Item from List step lets you take an item out of a list variable. You can remove an item by its value or by its spot (index) in the list. This helps you keep your data organized in your automated tasks.

## How to Use the Remove Item from List Step

Use this step to change a list variable by taking out specific things.

### Step 1: Add the Remove Item from List Step

1.  Open your process in the Robotiq.ai editor.
2.  Drag the **Remove Item from List** step into your workflow.

### Step 2: Set Up the Step Properties

1.  **Step Name** (Optional): Give the step a custom name. This helps you know what it does in your process.
2.  **Source list variable** (Required): Pick the list variable you want to change.
3.  Choose how to remove the item:
    -   **List index to remove** (Required): Type in an integer variable or a specific number for the item's spot. The first item is at index 0.
    -   **Element to remove** (Required): Type in a string or integer variable, or a specific value, to remove all items that match.
4.  **Ignore case** (Required):
    -   **T (True - default value)**: The step will not care about capitalization when looking for the element to remove. For example, "Apple" and "apple" are seen as the same.
    -   **F (False)**: The step will care about capitalization. "Apple" and "apple" are seen as different values.
5.  **Destination list variable** (Required): Pick an existing list variable or make a new one. This variable will hold the list after the item is removed.
6.  **Element count destination variable** (Required): Pick an existing integer variable or make a new one. This variable will hold the number of unique items left in the `Destination list variable`.

**Important:** You must give either a `List index to remove` OR an `Element to remove`, but not both.

## Parameters Explained

**Step Name** (Optional)

-   A custom name for this step in your process.
-   Example: `Remove Old Data`
-   Use it to make your workflow easier to understand.

**Source list variable** (Required)

-   The list variable you want to remove an item from.
-   Example: `my_data_list`
-   This is the original list the step will work with.

**List index to remove** (Required - if removing by position)

-   The spot (index) of the item to remove. The first item is index 0.
-   Example: `2` (removes the third item in the list)
-   Use this when you know exactly where the item you want to remove is.

**Element to remove** (Required - if removing by value)

-   The specific value of the item you want to remove. All items with this value will be removed.
-   Example: `"Expired Item"` or `item_to_delete_variable`
-   Use this when you want to remove all items that are a certain value.

**Ignore case** (Required)

-   Controls if the `Element to remove` search cares about capitalization.
-   **T (True)**: Doesn't care about capitalization (e.g., "apple" matches "Apple"). This is the default.
-   **F (False)**: Cares about capitalization (e.g., "apple" does not match "Apple").
-   Use `T` for flexible matching, `F` for exact matching.

**Destination list variable** (Required)

-   The variable that will hold the changed list after the item is removed.
-   Example: `updated_data_list`
-   You can use a list variable you already have or make a new one.

**Element count destination variable** (Required)

-   An integer variable that will hold the count of unique items in the `Destination list variable`.
-   Example: `unique_item_count`
-   This quickly tells you how many different items are left in your list.

## Related Articles

-   [Add New Element To List Step](https://docs.robotiq.ai/en/article/add-new-element-to-list-step) - Learn how to add items to a list.
-   [Define Variable Step](https://docs.robotiq.ai/en/article/define-variable-step) - Learn how to make new variables.
-   [Set Variable Value Step](https://docs.robotiq.ai/en/article/set-variable-value-step) - Learn how to change what an existing variable holds.

## Need Help?

Can't find what you're looking for? Join the [Robotiq Community](https://community.robotiq.ai/home/) to get help from other users and the Robotiq team.