# Insert Columns

This action is used to add a number of columns in an excel document.

## **Properties**

<figure><img src="https://649489153-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MSSr3DfBuOYIkk2T9ec%2Fuploads%2Fp5Uj5fkNBKCPCMuTUQvn%2Fimage.png?alt=media&#x26;token=96ebe4d7-a8fc-4967-a7b5-8358dcab4e37" alt=""><figcaption></figcaption></figure>

### **Input**

* **Excel Document**: File name for the target Excel document.
* **WorkSheet**: The target worksheet name.
* **Target Column**: The target cell. Columns will be inserted to the left of the specified column.
* **Column Count**: The number of columns to insert (default is 1).

{% hint style="info" %}
**Target Column**: This needs to be a cell (A1) and not a range (A1:C5).
{% endhint %}

### **Misc**

* **Display Name**: action display name in your implementation project
* **Wait Before**: number milliseconds robot to wait before executing the action.
* **Wait After:** number milliseconds robot to wait until moving to the next action.
* **Abort on Error**: True/False
* **Retry Times**: Specifies the number of times to retry an action if it doesn't end successfully. Default value 0 (no retry); Use -1 if you want to retry indefinitely.&#x20;

## **Use Case**

### **Potential Use Cases**

* Changing the format of the file by adding columns in it.

### **Examples of Using Insert Columns**

**Example**&#x20;

Watch the robot in action:

{% embed url="<https://www.youtube.com/watch?v=43y3Sm3slLw>" %}

You can check and download the example from here:

{% file src="<https://649489153-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MSSr3DfBuOYIkk2T9ec%2Fuploads%2FTSU8YeWbIP2d31lzQOWX%2FInsert%20Columns.zip?alt=media&token=5668d108-f060-4253-98db-9e27fb9622dd>" %}