How do you add a new module position?

From Joomla! Documentation

Split Page into Specific Joomla! Versions - J2.5 and 3.x

It has been suggested that this article or section be split into specific version Namespaces. (Discuss). If version split is not obvious, please allow split request to remain for 1 week pending discussions. Proposed since 6 years ago.


The list of available positions where you can insert a module is controlled by the template you are using. It is possible to add new positions to a template.

Joomla! 2.5 Joomla 2.5

Inserting the code

  • Open the index.php file of the Template you wish to edit
  • Locate the place in the Template where you wish to put the new position.
  • Insert
<jdoc:include type="modules" name="newposition"   />
  • The variable can be used (between existing tags) to replace an image by replacing the <img src="xxx" border="0" alt="">. Or By creating a new tag with its own class/id.
  • Open the Template's TemplateDetails.xml file and locate the
<positions></positions> Start and end tags 
  • Then add
  • Example

Viewing the changes

With Joomla 2.5 to see all of the existing template locations in your browser edit the Template manager options.

Template manager options

Then append "?tp=1",to the end of your normal URL (for example, "").

Joomla! 1.5 Joomla 1.5

In this example, we will add a new position to the default rhuk_milkyway template. Here are the steps.
  • Open the file "<your Joomla! home>/templates/rhuk_milkyway/index.php" for editing and determine where your new position will be on the page. Note that you can see all of the existing template locations in your browser by adding "?tp=1" to the end of your normal URL (for example, "").
  • In our example, we will add a new location after the "breadcrumb" position called "mynewposition". To do this, find the line in the file <div id="whitebox"> and insert a new line <jdoc:include type="modules" name="mynewposition" /> as shown below:
<div id="pathway">
   <jdoc:include type="modules" name="breadcrumb" />
   <div class="clr"></div>
   <div id="whitebox">
      <jdoc:include type="modules" name="mynewposition" />
   <div id="whitebox_t">
  • Open the file "<your Joomla! home>/templates/rhuk_milkyway/templateDetails.xml" for editing and find the "<positions>" section of the file. Add the new entry for "mynewposition" as shown below:

Now, when you look at your site with the "?tp=1" URL, you should see the new position as shown below:

New template position2.png

In the Module:[Edit] screen, the new position should display in the drop-down list box of available positions, as shown below.

New template position1.png