I'm trying to add a column to the sales/order grid in the backend. I've found some wonderfull tutorials, but I can't get it to work.

This is the tutorial I'm following.. http://www.atwix.com/magento/customize-orders-grid/

Though I want to display the city of the customer that placed the order.

The column is shown in the grid, but there is no content. I suspect that the query to add the sales/order table is incorrect, but I'm not sure what goes wrong here.

My code..

class Test_Manager_Block_Adminhtml_Order_Grid extends Mage_Adminhtml_Block_Widget_Grid


 public function __construct()



protected function _getCollectionClass()
    return 'sales/order_grid_collection';
protected function _prepareCollection()
    $collection = Mage::getResourceModel($this->_getCollectionClass());

    $collection->getSelect()->joinLeft('sales_flat_order_address', 'main_table.entity_id = sales_flat_order_address.parent_id',array('city'));

    return parent::_prepareCollection();
protected function _prepareColumns()
    $this->addColumn('real_order_id', array(
        'header'=> Mage::helper('sales')->__('Order #'),
        'width' => '80px',
        'type'  => 'text',
        'index' => 'increment_id',
    if (!Mage::app()->isSingleStoreMode()) {
        $this->addColumn('store_id', array(
            'header'    => Mage::helper('sales')->__('Purchased from (store)'),
            'index'     => 'store_id',
            'type'      => 'store',
            'store_view'=> true,
            'display_deleted' => true,
            'filter_index' => 'main_table.store_id'
    $this->addColumn('created_at', array(
        'header' => Mage::helper('sales')->__('Purchased On'),
        'index' => 'created_at',
        'type' => 'datetime',
        'width' => '100px',
        'filter_index' => 'main_table.created_at'
    $this->addColumn('billing_name', array(
        'header' => Mage::helper('sales')->__('Bill to Name'),
        'index' => 'billing_name',
   $this->addColumn('qty_ordered', array(
        'header'    => Mage::helper('sales')->__('Items Ordered'),
        'index'     => 'qty_ordered',
        'type'      => 'number',
        'total'     => 'sum'
    $this->addColumn('city', array(
        'header'    => Mage::helper('sales')->__('City'),
        'index'     => 'city',
        'type' => 'text'
    $this->addColumn('base_grand_total', array(
        'header' => Mage::helper('sales')->__('G.T. (Base)'),
        'index' => 'base_grand_total',
        'type'  => 'currency',
        'currency' => 'base_currency_code',
    $this->addColumn('grand_total', array(
        'header' => Mage::helper('sales')->__('G.T. (Purchased)'),
        'index' => 'grand_total',
        'type'  => 'currency',
        'currency' => 'order_currency_code',
    $this->addColumn('status', array(
        'header' => Mage::helper('sales')->__('Status'),
        'index' => 'status',
        'type'  => 'options',
        'width' => '70px',
        'options' => Mage::getSingleton('sales/order_config')->getStatuses(),
    return $this;
protected function _prepareMassaction()
    if (Mage::getSingleton('admin/session')->isAllowed('sales/order/actions/cancel')) {
        $this->getMassactionBlock()->addItem('cancel_order', array(
             'label'=> Mage::helper('sales')->__('Cancel'),
             'url'  => $this->getUrl('*/sales_order/massCancel'),
    if (Mage::getSingleton('admin/session')->isAllowed('sales/order/actions/hold')) {
        $this->getMassactionBlock()->addItem('hold_order', array(
             'label'=> Mage::helper('sales')->__('Hold'),
             'url'  => $this->getUrl('*/sales_order/massHold'),
    if (Mage::getSingleton('admin/session')->isAllowed('sales/order/actions/unhold')) {
        $this->getMassactionBlock()->addItem('unhold_order', array(
             'label'=> Mage::helper('sales')->__('Unhold'),
             'url'  => $this->getUrl('*/sales_order/massUnhold'),
    $this->getMassactionBlock()->addItem('pdfinvoices_order', array(
         'label'=> Mage::helper('sales')->__('Print Invoices'),
         'url'  => $this->getUrl('*/sales_order/pdfinvoices'),
    $this->getMassactionBlock()->addItem('pdfshipments_order', array(
         'label'=> Mage::helper('sales')->__('Print Packingslips'),
         'url'  => $this->getUrl('*/sales_order/pdfshipments'),
    $this->getMassactionBlock()->addItem('pdfcreditmemos_order', array(
         'label'=> Mage::helper('sales')->__('Print Credit Memos'),
         'url'  => $this->getUrl('*/sales_order/pdfcreditmemos'),
    $this->getMassactionBlock()->addItem('pdfdocs_order', array(
         'label'=> Mage::helper('sales')->__('Print All'),
         'url'  => $this->getUrl('*/sales_order/pdfdocs'),
    return $this;
public function getRowUrl($row)
    if (Mage::getSingleton('admin/session')->isAllowed('sales/order/actions/view')) {
        return $this->getUrl('*/sales_order/view', array('order_id' => $row->getId()));
    return false;
public function getGridUrl()
    return $this->getUrl('*/*/grid', array('_current'=>true));


---EDIT--- I've tried Amit's solution, but that didn't fill the column either.

I've also tried the method from the article..

In _prepareCollection

$collection->getSelect()->join(array('address_billing' =>

, 'main_table.entity_id = address_billing.parent_id AND
address_billing.address_type = "billing"',array('address_billing.city as billing_city'));

in _prepareColumns()

  $this->addColumn('city', array(
        'header' => Mage::helper('sales')->__(' Billing City'),
        'index' => 'billing_city',
        'filter_index' => 'address_billing.city',

This also doesn't fill the column. Also when I try to order the column, I get the error column not found 1054, unknown column 'address_billing.city' in 'order clause'. It seems like the field isn't added to the collection, but the query seems right to me.

I'm not sure what else could be wrong here.


3 Answers 3


This is a duplicate of the question Add Column to a grid (observer) - Column ‘store_id’ in where clause is ambiguous issue, here I explained how to add a column to the sales/order grid the right way (without file copy or a rewrite).

The sales/order grid uses the table sales_flat_order_grid to display its information, this is done to list all orders without adding joins and speeding-up the loading. In order to add a column to the grid you would need to add a field to this table and update the information in that field when an order is created/updated. Below the steps needed to add this to the grid:

I called the extension Example_SalesGrid, but you can change it to your own needs.

Let's start by creating the module init xml in /app/etc/modules/Example_SalesGrid.xml:

<?xml version="1.0" encoding="UTF-8"?>
 Module bootstrap file
                <Mage_Sales />

Next we create our module config xml in /app/code/community/Example/SalesGrid/etc/config.xml:

<?xml version="1.0" encoding="UTF-8"?>
            <version>0.1.0</version> <!-- define version for sql upgrade -->
            <!-- Add observer configuration -->
            <!-- initialize sql upgrade setup -->
            <!-- layout upgrade configuration -->

Now we create the sql upgrade script in /app/code/community/Example/SalesGrid/sql/example_salesgrid_setup/install-0.1.0.php:

 * Setup scripts, add new column and fulfills
 * its values to existing rows
// Add column to grid table

    'varchar(255) DEFAULT NULL'

// Add key to table for this field,
// it will improve the speed of searching & sorting by the field

// Now you need to fullfill existing rows with data from address table

$select = $this->getConnection()->select();
        'address.parent_id = order_grid.entity_id AND address.address_type = ?',
    array('customer_city' => 'city')
        array('order_grid' => $this->getTable('sales/order_grid'))


Next we create the layout update file in /app/design/adminhtml/default/default/layout/example/salesgrid.xml:

<?xml version="1.0"?>
    <!-- main layout definition that adds the column -->
        <reference name="sales_order.grid">
            <action method="addColumnAfter">
                <arguments module="sales" translate="header">
                    <header>Customer City</header>
    <!-- order grid action -->
        <!-- apply the layout handle defined above -->
        <update handle="add_order_grid_column_handle" />
    <!-- order grid view action -->
        <!-- apply the layout handle defined above -->
        <update handle="add_order_grid_column_handle" />

The last file needed is needed to update the data from a table other than sales/order (sales_flat_order). All fields in sales/order_grid matching the column name from sales/order is automatically updated in the sales/order_grid table.


 * Event observer model
class Example_SalesGrid_Model_Observer {

    public function addColumnToResource(Varien_Event_Observer $observer) {
        // Only needed if you use a table other than sales/order (sales_flat_order)

        $resource = $observer->getEvent()->getResource();
            array('billing_address_id' => 'entity_id'),

This code is based on the example from http://www.ecomdev.org/2010/07/27/adding-order-attribute-to-orders-grid-in-magento-1-4-1.html

Hope the example above solves your problem.

  • I have used your way for displaying shipping method in Order Grid, but how to display shipping method title in Grid and in code, play with shipping method code ?
    – Vicky Dev
    Commented Aug 19, 2016 at 6:48
  • 1
    I was looking for something like this, thank you Vlad. However sometimes the change you need to make is rather not worth it and is much easier just add field into grid instead..... anyway ;) Upvote
    – Rob D. A.
    Commented Jul 4, 2017 at 20:45

Try This way, Its works fine for me.i Assume that you will create your own module for this task rather than editing the core files. Add this line to your _prepareCollection function in you grid.php file

$collection = Mage::getResourceModel('sales/order_collection')
        ->join(array('a' => 'sales/order_address'), 'main_table.entity_id = a.parent_id AND a.address_type != \'billing\'', array(
            'city'       => 'city',
            'country_id' => 'country_id'

Add this lines to function _prepareColumns in grid.php file

$this->addColumn('city', array(
        'header' => $helper->__('City'),
        'index'  => 'city'

hope it will work.

  • This method actually does not worked for me without some modifications. Because I already had "City" in my collection just added $this->addColumn('city', array( 'header' => Mage::helper('sales')->__('City'), 'index' => 'city' )); and works as charm.
    – Rob D. A.
    Commented Jul 4, 2017 at 20:47

Just check out Enhanced Admin Grids. A so powerful and free extension from jayelkaake

Your Answer

By clicking “Post Your Answer”, you agree to our terms of service and acknowledge you have read our privacy policy.

Not the answer you're looking for? Browse other questions tagged or ask your own question.