
This tutorial has also been tested by Nishdo who successfully added a new module position in Joomla 2.5. See comments below.
This Joomla tutorial is created for Scott who asked me how to create a new module position inside a Joomla template ie Beez_20. Adding a new module position inside a Joomla 1.7 template is fairly simple with the most challenging step figuring out where you want to put the new module position. Use this post to find out where your module positions are located.
For my example: I will create a new module position
- Under my ‘Position-0’
- My new module position will be called ‘CmsMind-NewPosition’.
Overview of what needs to be done:
- Locate your current module positions
- In your FTP File Manager edit your Template file index.php
- In your FTP File Manager, edit your Template file TemplateDetails.xml
- Assign a module to your new module position
How to Add a New Module Position Inside a Joomla 1.7 Template:
1. Locate your current module positions
- Use this post to find out where your module positions are located.
2. In your FTP File Manager edit your Template file index.php

- Open up your FTP File Manager
- Find your Template Directory, ie:
- ../Joomla17/templates/Beez_20
- Edit your index.php file, ie:
- /index.php
- Locate where you want a new module position to be placed in your template
- Insert the following code:
<jdoc:include type="modules" name="CmsMind-NewPosition" />

3. In your FTP File Manager, edit your Template file TemplateDetails.xml
- Open your FTP File Manager
- Find your Template Details file ie:
- /Joomla17/templates/Beez_20/templateDetails.xml
- Find the <positions></positions> tags and insert the following line:
<position>CmsMind-NewPosition</position>
4. Assign a module to your new module position in Module Manager
- Login to your Joomla 1.7 Administrator backend
- Click on Extensions, Module Manager
- Choose an existing or a new Module
- In the details, set:
- Position = <the new position you created in step 1 and 2>
- Position = CMSMind-NewPosition
- Click on Save & Close

So that’s it. After you are done you can check out the new template module positions again via Step 1. You will see the new module position you added in red.
Thanks,
Thank you
Hi Levent,
No Problem!
Thanks for your visit,
elaine
This step by step tutorial really helped me find out how to set the “position” in Joomla. I must say thanks to you!
I did fellow your step but i don’t know why i don’t see the new modules position show up. I don’t know whats wrong
Hi Anthony,
If you are just starting off with Joomla, you dont need to add new module positions. There are plenty that are available to use. I would advise now to reinstall your instance of Joomla because I dont know what kind of changes you made ready.
Thanks for your visit,
Elaine
Why event i deleted he files position areas in index.php and xml files. But still not things happened or how any things in admin assign modules position, i try to clear all cookies but still the same i don’t know what wrong with it. If any one could will so appreciate
If any one could help i will be so appreciate
I want to put some modules position inside contents, that not have in the template:
Thank you so much, really apprciate your help!
Hi Philippa,
No problem, glad I could help.
Thanks for your visit,
elaine
hi!
thanks for this.
i have successfully added a position but when i publish it it comes on all my 5 pages.
how can i limit the position to only appear in the first page bearing in mind i have tried using the option for “appear only on selected pages ” but wont work.
Your help will be much appreciated.
Linda~
Hi,
I did each step and I am a super user with permission to do any changes, but when I try to save the changes on index.php it gives me an error “505 can’t open file. Permission denied”. (FWY: No problem editing an overwriting the Details.xml file). Any tip? Thanks!
Hi guys,
I did the same according to the tutorial, i displayed the module also..but the problem is that i can’t display the module only in front page or home page…i tried from the admin part to selected the “only selected pages ” option …but then nothing works….please help me guys…
I can’t get your instructions to work in 2.5. I’m trying to add a new module position at the very top of the page, above everything, to display ad banners. The position shows, but nothing displays inside it.
I need the same for Joomla2.5. Please help.
Hi Subrun,
I will take a look on how to implement this in Joomla 2.5.
Thanks,
elaine
Hi Elaine,
Many many thanks for this walkthrough and many others, just starting Joomla 2.5.x yesterday and have read a few of your articles, by far the best help I’ve seen so far.
As for the very last question posted by Subrun, I’ve run through this walkthrough for a Joomla 2.5 installation just now, and it works a treat, no problems at all with a new position, I’m very happy with my new slideshow position!
Cheers,
N.
Hi Nishdo,
Thanks for providing feedback on my tutorial for Joomla 2.5. I’m glad it worked for you!
Thanks for your visit,
elaine
ok…my question is..how you know where the new module will appear? I mean exactly position in webpage… Thx in advance.
-dusan-
Hi Dusan,
You have to do that in step 2. You should know some HTML programming and you should already know where you want the module position to show up when you add the code (in step 2). Sorry, yeah it comes down to understanding HTML programming.
Thanks for your visit,
elaine
Thank you!