Reposition Magento's admin grid column at first position

Reposition Magento's admin grid column at first position

August 8, 2026 · Illustrated author avatarBy Stefan Bogdanescu
Reposition Magento's admin grid column at first position

Repositioning Magento Admin Grid Column: A Comprehensive Guide

When working with custom Magento modules that extend admin grids, you’ll often need to reposition columns for better usability or data organization. The built-in $this->addColumnsOrder() method allows you to reorder columns, but placing a column at the very first position can be challenging.

Understanding the Default Grid Column Order

Before we dive into the solution, let’s understand the default order of Magento admin grid columns:

  1. Massaction checkbox: This is always the first column.
  2. Entity ID (entity_id): Unless you’ve reordered it.
  3. The rest of the columns in the order they were added to the collection.

The Challenge: Placing a Column First

The addColumnsOrder() method accepts two parameters: the ID of the column to be repositioned and the ID of the column after which to position it. So, if you want to place your custom column first, you might assume that using 'massaction' as the second parameter would work:

$this->addColumnsOrder($columnToRepositionID, 'massaction');

However, this doesn’t work because 'massaction' isn’t a valid column ID in the grid.

The Solution: Repositioning at the First Position

To place your custom column first without modifying core files or using the local/Mage/Adminhtml structure, you can do so by understanding how Magento populates the columns array:

  1. Identify your column’s position: In the Grid.php file of your module, find where $this->addColumn() is called for your custom column.
$this->addColumn('your_column_id', [
    // Column configuration...
]);
  1. Override and reorder: Create a new method in your grid class that overrides the default _prepareColumns() method:
protected function _prepareColumns()
{
    parent::_prepareColumns();

    $columns = $this->getColumns();
    $massactionIndex = array_search('massaction', array_column($columns, 'index'));
    if ($massactionIndex !== false) {
        $firstColumn = array_splice($columns, 0, 1);
        array_unshift($columns, ...$firstColumn); // Insert first column at the beginning
    }

    $this->setColumns($columns);
}
  1. Call your new method: In your Grid.php constructor or where you initiate the grid, call this new method:
public function __construct()
{
    parent::__construct();

    $this->_prepareColumns();
}

Best Practices and Warnings

  • Always make sure to use addColumn() in the correct order. Columns are added to an array internally.
  • Be aware that if you add or remove columns dynamically, this solution might not work as expected.
  • This method doesn’t modify core files, but it still modifies the behavior of the grid by overriding methods.

Conclusion

Repositioning Magento admin grid columns can be a bit tricky, especially when trying to place them at the first position. By understanding how the addColumn() method works and using array manipulation techniques, you can achieve this without touching core files or using the local/Mage/Adminhtml structure.

Remember, maintaining clean code is paramount in Magento development. Always strive for a balance between customization and keeping your codebase lean and maintainable.

For more advanced topics on Magento grid customization, I highly recommend checking out this comprehensive guide from Laravel Company.

API Extensions Themes Admin

Our network