# Insert proc (list)

Source: https://ref.dm-lang.org/list/proc/Insert

### Format
> `list.Insert(Index,Item1,Item2...)`

### Returns
> The index following the inserted items.

### Args
- `Index`: The index where the new item will be inserted. Any value already at that index will be pushed forward.
- `Item1`: A value or list of values to insert.
- `Item2...`: (optional) Additional items to insert, immediately after the previous item(s).


Insert values into a list at a specific point. Using Index=0 or Index=list.len+1 is the same as adding to the list.

If any of the items you insert is itself a list, its elements will be inserted instead of the list itself.

> [!note]
> 
> This proc doesn't work with many special lists such as `contents` or `overlays`.

### See also
- [Cut proc (list)](https://ref.dm-lang.org/list/proc/Cut.md)
- [Copy proc (list)](https://ref.dm-lang.org/list/proc/Copy.md)
- [Swap proc (list)](https://ref.dm-lang.org/list/proc/Swap.md)