Profile picture for user admin
Daniel Sipos
19 Dec 2012

The conventional way of adding a new region to your theme in Drupal 7 is by editing the .info file and declaring it in there. However, there are ways you can achieve similar effects dynamically - from a custom module.

As you know, declaring a region in the theme’s .info file is not always useful: you have to manually declare it and it's not a useful way if you are writing a module that needs to dynamically create new regions. Enter hook_system_info_alter().

This Drupal hook takes three arguments(&$info, $file, $type) and alters the data transmitted to Drupal from both theme and module .info files. So in order to make Drupal register another region from your .module file, you would write something like this:

 * Implements hook_system_info_alter().
function your_module_name_system_info_alter(&$info, $file, $type) {
  if ($type == 'theme') {
    $info['regions']['region_machine_name'] = t('Region name');

You need to make the following word replacements though:

  • your_module_name = The machine readable name of your module;
  • region_machine_name = The machine name of your region

This function will check that the type it targets to alter is a theme (not a module) and alters the $info variable by adding a new region - with its readable and machine names. But remember, for this to take effect, the caches need to be cleared. So if you intend to use this dynamically, don’t forget the existence of this functions: cache_clear_all();

OK, so hope this helps. Let me know if you run into some problems.

Profile picture for user admin

Daniel Sipos

CEO @ Web Omelette

Danny founded WEBOMELETTE in 2012 as a passion project, mostly writing about Drupal problems he faced day to day, as well as about new technologies and things that he thought other developers would find useful. Now he now manages a team of developers and designers, delivering quality products that make businesses successful.

Contact us


btopro 19 Dec 2012 17:46

Regions module

Regions module also provides a nice little structure/api for doing this quickly, worth at least a look.

Craig 19 Dec 2012 17:08

Use case?

I'm struggling to see a use-case for this. Is there an advantage to using this over adding it to the theme's .info file?

Yannis 19 Dec 2012 17:07


Why would someone want to do that? Can you provide a use case?

tenken 19 Dec 2012 17:48

optimize blog entry regarding live or big drupal site ...

I appreciate being informed about such a useful hook I had previously overlooked. I usually do this via the info file.

While you mention cache_clear_all() ... for a Live site with huge amounts of content would it be valuable to specify a better example for clearing the cache, something like:

// Possibly target just your theme_name as well ...
cache_clear_all('theme_registry:*', 'cache', TRUE);

calling just cache_clear_all() would likely wipe the page and block cache as well -- which could be bad.

Daniel Sipos 19 Dec 2012 19:10

Thanks for the comments!

Thanks for the comments!

@btopro, I will definitely check it out!
@Craig, there can be cases in which you need to generate new regions for a particular module you are writing. I did it and saw other modules that do it.
@tenken, good point!



Bhavin Joshi 20 Dec 2012 06:15

I don't think this is useful.

I don't think this is useful. Because while debugging or working with themes, you do not have control over programmatically created regions.

Daniel Sipos 20 Dec 2012 11:36

In reply to by Bhavin Joshi (not verified)

Programatically creating a

Programatically creating a new region does not mean you place it in a theme. It gets created for you to use it however you want.

There are modules that create new regions to be used dynamically by it without interfering with the theme layer.

Thanks for the comment.

Bruce C 18 Oct 2013 22:46

In reply to by admin

Thanks, Danny, but how to you add that region to the theme?

This is good info and a very useful hook, but is there a way to make Drupal using this hook to add the page render code in a theme template like page.tpl.php for example?

Bruce C 21 Oct 2013 19:14

In reply to by admin

Thanks, but 2 additional questions on this...

Thanks for your quick reply, but:

  1. How would using block_get_blocks_by_region() tell Drupal exactly WHERE in the template to place that block region?

  2. How is this different from adding print render($page['REGION-NAME']) to a .tpl file?


Daniel Sipos 22 Oct 2013 11:39

In reply to by Bruce C (not verified)

Hey there,

Hey there,

Seems you are trying to do things wrong. If you want a new region in your theme, just declare it in the theme .info file and then print it in the template file like usual. If you need the region in a module and then print it within the framework of the module (not theme), you can use this hook: hook_system_info_alter() to declare it and have it available.

Bruce 22 Oct 2013 13:08

In reply to by admin

Understood, but if I do it with the module...

But if I use hook_system_into_alter(), how does Drupal know exactly where I want that block region to print?

Daniel Sipos 22 Oct 2013 14:24

In reply to by Bruce (not verified)

You don't use this hook to

You don't use this hook to print the region, you are using it to hook into the Drupal system info and add new stuff what is loaded from the .info file. You just basically declare a new region with this hook.

Then you can do what you want with it in your module. Check out Block Inject to see how it's used there.

Kolade Ige 23 Jan 2015 08:34

In reply to by Bruce C (not verified)

Render it any where you want

Just like this $reg = block_get_blocks_by_region(<region_machine_name>);
$reg_markup = render($reg);

print $reg_markup;

So, assuming that you what to add it to a form, you can do something like this
hook_form_name_form($form, &$form_state){
$reg = block_get_blocks_by_region('health_left_panel');
$reg_markup = render($reg);

$form ['markup'] = array(
        '#type' => 'markup',
        '#markup' => '<div id="form_markup">'.$reg_markup.'</div>'

  return $form;


Drupal Theme Garden 20 Dec 2012 12:39

Thanx for this, but ...

Thanx for this, but ...
Can you explain some useful scenario with this technique.

Add new comment