How to create a custom grid from scratch

How to create a custom grid from scratch

We received a request from a client where they wanted to implement an expanded order grid while still keeping the default Magento’s one. For this example we’ll create a new module named Inchoo Orders.

Step 1.

Create new module in etc/modules called Inchoo_Orders.xml

<?xml version="1.0"?>

Step 2.

Next thing we’ll do is create folder Inchoo/Orders inside app/code/community and inside we’ll make few folders: Block, controllers, etc, Helper.


Step 3.

Create config.xml inside etc folder.

<?xml version="1.0"?>
<inchoo_orders before="Mage_Adminhtml">Inchoo_Orders_Adminhtml</inchoo_orders>

Step 4

Create adminhtml.xml file inside etc folder which will add a link to our orders page in magento admin panel.

<?xml version="1.0"?>
<inchoo_orders translate="title" module="inchoo_orders">
<title>Orders - Inchoo</title>

Step 5

Create blank helper class.

class Inchoo_Orders_Helper_Data extends Mage_Core_Helper_Abstract

Step 6

Next step is to create controller for our grid.

class Inchoo_Orders_Adminhtml_OrderController extends Mage_Adminhtml_Controller_Action
public function indexAction()
$this->_title($this->__('Sales'))->_title($this->__('Orders Inchoo'));
public function gridAction()
public function exportInchooCsvAction()
$fileName = 'orders_inchoo.csv';
$grid = $this->getLayout()->createBlock('inchoo_orders/adminhtml_sales_order_grid');
$this->_prepareDownloadResponse($fileName, $grid->getCsvFile());
public function exportInchooExcelAction()
$fileName = 'orders_inchoo.xml';
$grid = $this->getLayout()->createBlock('inchoo_orders/adminhtml_sales_order_grid');
$this->_prepareDownloadResponse($fileName, $grid->getExcelFile($fileName));

Step 7

Next thing we do is create grid container in Block/Adminhtml/Sales/Order.php

class Inchoo_Orders_Block_Adminhtml_Sales_Order extends Mage_Adminhtml_Block_Widget_Grid_Container
public function __construct()
$this->_blockGroup = 'inchoo_orders';
$this->_controller = 'adminhtml_sales_order';
$this->_headerText = Mage::helper('inchoo_orders')->__('Orders - Inchoo');

Step 8

Last step is making grid class in Block/Adminhtml/Sales/Order/Grid.php

class Inchoo_Orders_Block_Adminhtml_Sales_Order_Grid extends Mage_Adminhtml_Block_Widget_Grid
public function __construct()
protected function _prepareCollection()
$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'
->join(array('c' => 'customer/customer_group'), 'main_table.customer_group_id = c.customer_group_id', array(
'customer_group_code' => 'customer_group_code'
'CONCAT({{customer_firstname}}, \' \', {{customer_lastname}})',
array('customer_firstname' => 'main_table.customer_firstname', 'customer_lastname' => 'main_table.customer_lastname'))
FROM sales_flat_order_item x
WHERE {{entity_id}} = x.order_id
AND x.product_type != \'configurable\')',
array('entity_id' => 'main_table.entity_id')
return $this;
protected function _prepareColumns()
$helper = Mage::helper('inchoo_orders');
$currency = (string) Mage::getStoreConfig(Mage_Directory_Model_Currency::XML_PATH_CURRENCY_BASE);
$this->addColumn('increment_id', array(
'header' => $helper->__('Order #'),
'index' => 'increment_id'
$this->addColumn('purchased_on', array(
'header' => $helper->__('Purchased On'),
'type' => 'datetime',
'index' => 'created_at'
$this->addColumn('products', array(
'header' => $helper->__('Products Purchased'),
'index' => 'products',
'filter_index' => '(SELECT GROUP_CONCAT(\' \', FROM sales_flat_order_item x WHERE main_table.entity_id = x.order_id AND x.product_type != \'configurable\')'
$this->addColumn('fullname', array(
'header' => $helper->__('Name'),
'index' => 'fullname',
'filter_index' => 'CONCAT(customer_firstname, \' \', customer_lastname)'
$this->addColumn('city', array(
'header' => $helper->__('City'),
'index' => 'city'
$this->addColumn('country', array(
'header' => $helper->__('Country'),
'index' => 'country_id',
'renderer' => 'adminhtml/widget_grid_column_renderer_country'
$this->addColumn('customer_group', array(
'header' => $helper->__('Customer Group'),
'index' => 'customer_group_code'
$this->addColumn('grand_total', array(
'header' => $helper->__('Grand Total'),
'index' => 'grand_total',
'type' => 'currency',
'currency_code' => $currency
$this->addColumn('shipping_method', array(
'header' => $helper->__('Shipping Method'),
'index' => 'shipping_description'
$this->addColumn('order_status', array(
'header' => $helper->__('Status'),
'index' => 'status',
'type' => 'options',
'options' => Mage::getSingleton('sales/order_config')->getStatuses(),
$this->addExportType('*/*/exportInchooCsv', $helper->__('CSV'));
$this->addExportType('*/*/exportInchooExcel', $helper->__('Excel XML'));
return parent::_prepareColumns();
public function getGridUrl()
return $this->getUrl('*/*/grid', array('_current'=>true));

Our new custom orders page can be accessed by going to Sales -> Orders – Inchoo in admin panel.

link in admin

End result should be something like this:

inchoo orders grid

However, if you’re having trouble with Magento development, we would be happy to help. Our team of experts can check out your site and get you a detailed report based on a personalized technical audit. Feel free to get in touch!

Related Inchoo Services

You made it all the way down here so you must have enjoyed this post! You may also like:

How to manage clients, pressure and stress Zelimir Gusak
Zelimir Gusak, | 3

How to manage clients, pressure and stress

Magento Grid Serializer for Ajax Grids Damir Korpar
Damir Korpar, | 10

Magento Grid Serializer for Ajax Grids

Filter order grid by multiple ID’s Petar Sambolek
Petar Sambolek, | 14

Filter order grid by multiple ID’s


  1. July 6, 2018 and still works magento CE
    However I need To add Product attributes please let me know if its possible

  2. I have the blank screen error. I narroved it to the line


    . If I comment out the line, I have at least Magento Header and footer and blank white between. So there’s something with the function or the Grid.php. Version is What have changed?

  3. Hi thanks for the tutorial I followed all steps exactly, refresh the admin page but no ‘Inchoo Orders’ item appearing under Sales menu ? Is something else needed (cache clearing / smth)? If yes, can you include it in the tutorial ?

    1. ah ok got it had wrong codePool (should have been ‘local’ since I put my code under local not community, community should be reserved for 3rd party ‘community’ code)

  4. Great article for some one who knows magento little bit.Please update the article with file paths too

  5. sir i have created module but it displaying only menu and not showing the table the grid is not working proper

  6. Working great thanks. I have a dought.
    Now i am able to see custom grid, instead of sales model i need to display my own table values into it(Product faqs). I have a product faqs table, i need to fetch from this table and display.
    How can i do this please someone help.

  7. Regarding “Fatal error: Call to a member function setSaveParametersInSession() on a non-object in ”

    Guys… this is happening becouse of folder path…
    Order.php should in “\Block\Adminhtml\Sales”
    Grid.php should in “\Block\Adminhtml\Sales\Order”

    Thanks Enjoy…..

  8. Resolution for 404 Page Not found is to move your controller to adminhtml folder with-in the controllers folder.

  9. hello guys help me in step 5.
    which path of “Create blank helper class.”
    and step 6
    which path of “create controller for our grid”

  10. I have followed all steps and Order – Inchoo sub menu is there in Sales menu but when I click on it, it leads to 404 Page Not found. could you tell what is the missing part.. I have checked it lots of time.

  11. what is the importance of this function..?
    public function gridAction()
    it never called

  12. Use this code to add ACL in adminhtml.xml

           <!--- menu ---- -->
                        <sales translate="title" module="inchoo_orders">
                                    <title>Inchoo Orders Menu</title>
  13. How to make the row clickable , I mean, I used getrowurl for it but I want to make a custom sales_order/view block inside incho_orders module. how can i do that?

    1. So okay I found it. Would be nice if this was clearly mentioned in the tutorial.

      For those of you who were also looking for this, in case if you want to add several custom grids, or you just want to have it a more suitable name. You CAN change the url route for the grid.

      So for example if you want to change “adminhtml/order/” to “adminhtml/mygrid/”.

      In the adminhtml.xml change adminhtml/order/ to adminhtml/mygrid/

      Then change the file AND classname of the controller in controllers/Adminhtml/ from OrderController.php to MygridController.php (Yes you should put the controller in the Adminhtml subfolder for it to work, something they also didn’t mention in this tutorial)

      Of course make sure you change the class name of the controller as well. That’s it.

  14. hello my first question is where i can create helper class
    and second is contoller
    plz give path

  15. Its working fine only we have to do is please place our controller in adminhtml folder

  16. Change adminhtml.xml tag content like this :
    This Will Work Fine

  17. Try to use filter on Name or Products Purchased. There is a problem with filter index on these 2 columns:

     $this->addColumn('products', array(
                'header'       => $helper->__('Products Purchased'),
                'index'        => 'products',
                'filter_index' => '(SELECT GROUP_CONCAT(\' \', FROM sales_flat_order_item x WHERE main_table.entity_id = x.order_id AND x.product_type != \'configurable\')'
            $this->addColumn('fullname', array(
                'header'       => $helper->__('Name'),
                'index'        => 'fullname',
                'filter_index' => 'CONCAT(customer_firstname, \' \', customer_lastname)'

    When filter_index value is added to MySQL query it is wrapped inside “, what makes SQL error.

    SELECT COUNT(*) FROM `sales_flat_order` AS `main_table`
      INNER JOIN `sales_flat_order_address` AS `a` ON main_table.entity_id = a.parent_id AND a.address_type != 'billing'
      INNER JOIN `customer_group` AS `c` ON main_table.customer_group_id = c.customer_group_id WHERE (`CONCAT(customer_firstname, ' ', customer_lastname)` LIKE '%Doe%')
    1. I am getting same error as below:
      Unknown column ‘CONCAT(firstname, ‘ ‘, lastname)’ in ‘where clause’

      Please provide solution.

    2. Same problem with products filtering, solved with this (Grid.php):

      protected function _productsFilter($collection, $column)
      if (!$value = $column->getFilter()->getValue()) {
      return $this;

      "(SELECT GROUP_CONCAT(' ', FROM sales_flat_order_item x WHERE x.product_type !='configurable' AND main_table.entity_id = x.order_id ) LIKE ?"
      , "%$value%");
      return $this;

      in _prepareColumns method:

      $this->addColumn('products', array(
      'header' => $helper->__('Prodotti Acquistati'),
      'index' => 'products',
      'filter_condition_callback' => array($this, '_productsFilter')

  18. Hi, Thank You the code ..
    Please Help Me i got a error Call to a member function setSaveParametersInSession() .
    Please give a guidance for it ..

  19. Hi,
    I followed all steps you defined above.But when i click on “Order-Inchoo” it shows 404 error.why?

  20. I have followed all steps and Order – Inchoo sub menu is there in Sales menu but when I click on it, it leads to 404 Page Not found. could you tell what is the missing part.. I have checked it lots of time.

  21. Not working as all,
    not even visible in menu.and many folks having same issue i can read that

  22. help me
    Latest Message: Second Reminder: Download and install Magento critical security patches now. Read details

  23. I can see blank page with no content.
    I have puth my controller on proper place, also try to put it in local folder with respective path.
    still not getting any output .
    Need your suggestions.

  24. Hi guys! Thanks for you post. It helped me to understand grids building.
    Here is precondition:
    I had some rules form in admin, that was available by */*/edit url. Purpose was to integrate tabs and grid from a bit another location with own controller. This form moved to General tab, in the second one I integrated form with grid (like in quote_promo manage coupon codes in native Magento). As a result I got smth like that.
    Faced with the next problem:
    When I try to search smth in grid, f.e. coupon code by typing query and pressing Enter button, I see in Firebug console that query processing to (ajax) grid url is terminated and then redirect happens to Save action (form action), and since there is no rule_id in POST data, it redirects to rule index page with grid.

    Do you have any idea why is that happen?
    Seems like there is some bind to input that ‘trigger’ save action method.

    Thanks for your reply!
    Waiting for it so much!

  25. Wonderful article works great on magento 1.9.1
    For all those who are getting errors, make these changes only :
    add your controller to app\code\local\Inchoo\Orders\controllers\Adminhtml\OrderController.php

    And tell me if anyone interested to view order on click. I have managed to sort it out. Enjoy magento !

  26. Hi Vedran, Thank you for the nice tutorial and I installed it on my magento. Meanwhile, I would like to filter the results by Store wise(I have multiple stores). Could you please let me know, how can we place a store filter drop down in the top of the order lising.

  27. Vedran, thank you very much for these great tutorial. I have one problem with this. If you click multiple times on the upper header to sort the fields an error message appears.
    The error is:
    Item (Mage_Sales_Model_Order) with the same id “1242” already exists.

    Do you have any idea why this could happen. BTW: I haven’t changed anything to your sourcecode for this test.
    Best regards

  28. Hi,
    I follow all instruction at last it showing page not found in localhost wamp which I newly installed, please help me

  29. Fatal error: Call to a member function setSaveParametersInSession() on a non-object in /opt/lampp/htdocs/layoutmagento/app/code/core/Mage/Adminhtml/Block/Widget/Grid/Container.php on line 66

    I have error in the same code you have writte above. Please help me

  30. Hi

    i have error in the same you have written above

    Fatal error: Call to a member function setSaveParametersInSession() on a non-object in /opt/lampp/htdocs/layoutmagento/app/code/core/Mage/Adminhtml/Block/Widget/Grid/Container.php on line 66

    Please help.

    1. how did you sort this out ,,, can you help me ,, i have same error , plz help

  31. Fatal error: Call to a member function setSaveParametersInSession() on a non-object in /opt/lampp/htdocs/layoutmagento/app/code/core/Mage/Adminhtml/Block/Widget/Grid/Container.php on line 66

  32. I have the blank screen error. I narroved it to the line


    . If I comment out the line, I have at least Magento Header and footer and blank white between. So there’s something with the fuction or the Grid.php. Version is What have changed?

  33. Hi Vedran

    I have used this and it is working fine.
    I want to make some checks in query by using my custom table. Could you please guide me how can i implement this in grid.php ?

    Thanks in advance

    1. Hai I am also seeking the requirement I need to display the orders from custom created tables. Did u got the idea Please share if any code available to implement. Thanks in advance

  34. HI first of all thanks for such a nice post.It works perfect.

    But i have a some confusion in the config.xml file.

    in that there is a model


    we have defined but we dont have a model class for this so why dont it has raise a errot .
    Please tell me i just learning magento extensions


    1. Hi Azhar,

      its not working with me and i got 404 error. Can you please help me out.


  35. This helped so much!!! For those having issues with the 404 page, you most likely do not have the OrderController.php in the right folder. It should be controllers/Adminhtml/OrderController.php

  36. Perfect – Was looking for something like this for ages. I can confirm this works perfectly on the new version of 1.8.1 as well.

  37. i try to use this code but not working and give black screen.

    please Vedran Sola why this not work??

    thanks in advanced

  38. For those getting a 404 Not Found Error when trying to access the grid, I found the issue was where I put my OrderController.php file. It needs to be Inchoo/Orders/controllers/Adminhtml/OrderController.php

    Originally I had put it in Inchoo/Orders/controllers/OrderController.php and this doesn’t work.

  39. Hi,
    This is very good extension. In our custom grid orders are showing but it better link provide to the orders to the order detailed page. Can you please guide the hyperlink to redirect the order page when we click on that order.

  40. I am gettign this error whenever I tried to open this module from admin site
    Parse error: syntax error, unexpected ‘Â Â Â Â public’ (T_STRING), expecting function (T_FUNCTION) in C:\xampp\htdocs\magento\app\code\community\Inchoo\Orders\controllers\Adminhtml\OrderController.php on line 9

    Can anyone help me for that

  41. I make my own module using your concept but grid content are not shown… help me out to fix this problem

  42. Thank you very much for your post!
    Anyone know how to generate in a cronjob the csv with this content?
    is for integration with a sales soft
    thankyou in advance

  43. Sam at RocketTheme helped me out with the database prefix issue.

    Change out the table name:


    With this:


    That will retrieve any prefix for your current install.

  44. Looks like this adds the row url, which I just pulled from the core Grid.php file:

    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;

    That added just above the grid url code near the end.

  45. Got things working and this is a great walk through.

    Two things I noticed are that a database table prefix needs to be defined in the Grid.php file code and that the row does not link to the order details.

    Is it possible to get the row linked to the order details?

  46. Y i need to just make a file in helper when there is no data in it ? I am just declaring the file & not writing any content in it.

  47. Hi,
    I can see the Order – Inchoo under the Sales tab in the admin. However when I click on it, it gives me a 404 error.
    Below is the link it is pointing to:

    Is this link correct? I have verified the file structure and it is same as mentioned above.
    I am guessing something is wrong with my etc/adminhtml.xml.

    Orders – Bakery

    Please advice.


  48. Hi,
    I am running magento 1.7, and followed the steps above to create a new grid. However when I click on it from the admin page, I get a 404, page not found error. I don’t see the new grid details :((.
    Please help.


  49. I got same errors so I just changed few lines.

    Wrong :
    class Inchoo_Orders_Adminhtml_OrderController extends Mage_Adminhtml_Controller_Action

    Right :
    class Inchoo_Orders_Adminhtml_OrdersController extends Mage_Adminhtml_Sales_OrderController


    in adminhtml.xml

    Orders – Inchoo

  50. Hello ,

    I am facing the same problem as of Hissam Roohi.

    What could be the issue?? I think that might be the issue due to some wrong configuration. Can you please let me know what could be the issue

  51. When i click the Orders- Inchoo sub menu , i am getting the error ‘The page you requested was not found, and we have a fine guess why.’

    After clicking it is redirecting the below url :


    @Vedran Sola -Can you please help me out

  52. Data.php is helper and controller class should go to controllers/Adminhtml/Order.php

  53. Hey Vedran,
    This looks very interesting. I got lost at steps 5 and 6. What files should contain the blank helper class and the controller for our grid?

  54. @Kieran

    gridAction is being called by getGridUrl method in Grid.php and its purpose is to enable grid filtering using ajax.

  55. Hi,

    I have followed your guide but when I click on the link it simple gives me a blank screen not showing the grid. One thing i was wondering, where does it call the gridAction from the controller?

  56. Very interesting. For my experience a current problem is to create a master/details grid. Have you got a road to?

Leave a Reply

Your email address will not be published. Required fields are marked *

You may use these HTML tags and attributes: <a href="" title=""> <blockquote cite=""> <code> <del datetime=""> <em> <s> <strike> <strong>. You may use following syntax for source code: <pre><code>$current = "Inchoo";</code></pre>.

Tell us about your project

Drop us a line. We'd love to know more about your project.