Python Pandas - Insert a new index value at a specific position

To insert a new index value at a specific position, use the index.insert() method in Pandas. This method returns a new Index object with the value inserted at the specified position.

Syntax

The syntax for the insert() method is ?

index.insert(loc, item)

Parameters

• loc ? Integer position where the new value will be inserted
• item ? The value to be inserted into the index

Creating a Pandas Index

First, let's create a basic Pandas Index with some transportation vehicles ?

import pandas as pd

# Creating the Pandas index
index = pd.Index(['Car', 'Bike', 'Airplane', 'Ship', 'Truck'])

# Display the index
print("Original Pandas Index:")
print(index)
print("\nThe dtype object:")
print(index.dtype)

Original Pandas Index:
Index(['Car', 'Bike', 'Airplane', 'Ship', 'Truck'], dtype='object')

The dtype object:
object

Inserting at a Specific Position

Now let's insert a new value 'Suburban' at position 2 (which becomes the 3rd element) ?

import pandas as pd

index = pd.Index(['Car', 'Bike', 'Airplane', 'Ship', 'Truck'])

# Insert 'Suburban' at position 2
new_index = index.insert(2, 'Suburban')

print("After inserting 'Suburban' at position 2:")
print(new_index)

After inserting 'Suburban' at position 2:
Index(['Car', 'Bike', 'Suburban', 'Airplane', 'Ship', 'Truck'], dtype='object')

Multiple Insert Operations

You can chain multiple insert operations to add several values ?

import pandas as pd

index = pd.Index(['Car', 'Bike', 'Airplane'])

# Insert multiple values at different positions
new_index = index.insert(0, 'Bus').insert(2, 'Train').insert(5, 'Boat')

print("Original index:")
print(index)
print("\nAfter multiple insertions:")
print(new_index)

Original index:
Index(['Car', 'Bike', 'Airplane'], dtype='object')

After multiple insertions:
Index(['Bus', 'Car', 'Train', 'Bike', 'Airplane', 'Boat'], dtype='object')

Key Points

• The insert() method returns a new Index object; it doesn't modify the original index
• Position counting starts from 0
• You can insert at any valid position from 0 to the length of the index
• The original index remains unchanged after the operation

Conclusion

The index.insert() method provides a clean way to add new values at specific positions in a Pandas Index. Remember that it returns a new Index object rather than modifying the original one.