What is Dispatch in Blocks?


In Blocks and under Location there is a mandatory field called “Dispatch” which contains a drop down with Categories, Catalog etc

What is this field for?

Hello jmccann,

Thank you for your message.

In the Dispatch drop-down list, you should choose a specific page or page type with that the location will be associated. The dispatch parameter has the following format:


where [controller_name] – is the name of the controller and [mode_name] – is the mode in which the controller works. This value is added to index.php?dispatch= part of the page and points to a specific location. For example, index.php?dispatch=checkout.cart points to the cart contents page while index.php?dispatch=checkout.checkout points to the checkout page.

Also there is the ability to create a custom location. It was developed for the cases when you have your own custom controllers created. For example, you have created the custom.php file in the controllers/customer directory of your CS-Cart installation and specified some mode in this file (e.g. it is called custom_mode). After this you will have a working custom page in the storefront which can be opened by the following URL:


So for this page you will be able to manage blocks after creating the custom.custom_mode custom location.

This information also can be found in our Reference guide:


I hope I have managed to answer your question.

Pavel Zyukin

CS-Cart Support team

Please note, that you must create both controller and a view template in order to get Custom Location work properly.

This means:

  1. create [font=courier new,courier,monospace]controllers/custom.php[/font] file and place this code inside:
if ( !defined('AREA') ) { die('Access denied'); }
```<br />
<br />
2) create s[b][font=courier new,courier,monospace]kins/basic/customer/views/custom[/font][/b] directory and an empty [font=courier new,courier,monospace][b]mode_name.tpl [/b][/font]file in it.<br />
<br />
3) open [b]Administration Panel [/b]and go to [b]Degin -> Blocks [/b]menu, where click [b]Add Location[/b] button. Select [b]Custom[/b] from the [b]Dispatch[/b] drop-down list and fill text box to the right with [b]custom.mode_name[/b], then fill-in any [b]Name[/b] and save. You might want to customise layout by adding grids or blocks.<br />
<br />
4) Navigate to [b]example.com/index.php?dispatch=custom.mode_name[/b] to see your custom layout.<br />
<br />
5) PROFIT! <img src="upload://rA9Qa8gnUPZzRZRdI8kt3dpjkrs.png" class="bbc_emoticon" alt=":)">

this is not working for me…


i have location called Blog… custom and custom.blog

got /skins/basic/customer/views/custom/blog.tpl with “asdf” in it/.

also put in

/stores/7/skins/basic/customer/views/custom no change…get a 404 even after a ?cc

any idea ?

i just need a location with a page that will pull an iframe

[quote name='Zahhar' timestamp='1344437996' post='142471']


  1. create [font=courier new,courier,monospace]controllers/custom.php[/font] file […]


    It should be [font=courier new,courier,monospace]controllers/customer/custom.php[/font], otherwise error 404 occured.

    However displayed document has a very weird stucture, like:

Untitled Document
.cm-noscript {display:none}

title given as Page Title in the editing location form


Can anybody help provide a guide to 4.0.3? That articles dont really help. I tried the steps above and get a blank page. thanks!