MediaWiki Namespaces — Talk Pages, User Pages, Help Pages Explained

In this tutorial, you'll learn about MediaWiki namespaces — how MediaWiki organizes different types of content using prefixes like Talk:, User:, and Help:. This is Lesson 6 of our project: Build Your Own Documentation Wiki.

What You'll Build Today

By the end of this lesson, you will have:

• A user page (your profile)
• A talk page discussion with proper formatting
• A help page for your wiki's users
• Understanding of all 17 default namespaces

Your wiki now has not just content, but community infrastructure — places for discussion, profiles, and help.

What is a Namespace?

A namespace is a prefix that tells MediaWiki what type of content a page contains. The namespace determines:

• How the page is displayed
• What permissions apply
• How the page appears in search
• What special features are available

Think of namespaces like folders on your computer. You have Documents (articles), Downloads (files), Desktop (user pages), and Trash (deleted pages). Each folder has different rules, but they all live in the same file system.

The Default Namespaces

MediaWiki comes with 17 namespaces. Here are the ones you'll use most:

Step-by-Step: Use Namespaces in Practice

Step 1: Create Your User Page

Your user page is your profile on the wiki. Other users can see who you are and what you work on.

1. Make sure you're logged in
2. Click your username at the top-right corner of any page
3. You'll see a red link — your user page doesn't exist yet. Click "Create"
4. Add this content:

== About Me ==

I'm the administrator of this wiki. I set it up to document our team's projects and knowledge.

== What I Do ==

* Maintain the wiki
* Write documentation
* Help team members with editing

== Contact ==

Leave a message on my [[User talk:YourUsername|talk page]].

5. Write an edit summary: Created user page
6. Click "Publish changes"

Step 2: Leave a Message on a Talk Page

Every page in MediaWiki has a corresponding Talk page for discussion. Talk pages work like a forum thread — you post a message, someone replies, and the conversation is preserved.

Let's leave a message on your own talk page to see how it works.

1. Go to http://localhost/mediawiki/index.php/User_talk:YourUsername (Replace "YourUsername" with your actual username)
2. This is a red link — create the page
3. Add this content:

== Welcome ==

Welcome to your talk page! This is where other users leave messages for you.

To reply to a message:
# Click '''Edit''' on the talk page
# Add your reply below the message
# Start your reply with a '''colon''' (:) to indent it
# Sign your message with four tildes: <nowiki>~~~~</nowiki>

Here's an example conversation:

'''User1:''' Can you review the API Reference page? ~~~~

:'''You:''' Sure, I'll look at it today. ~~~~

4. Write an edit summary: Created talk page with instructions
5. Click "Publish changes"

Now look at how the page renders. Notice:

• The ~~~~ turned into your username and a timestamp
• The colons (:) created indented replies
• The conversation has a clear thread structure

Step 3: Use Indentation Correctly

Talk page discussions use colons for indentation. The convention is:

Original message (no indent)
:Reply (1 colon = 1 level)
::Reply to the reply (2 colons)
:::And so on (3 colons)

Each colon adds one level of indentation. This creates a threaded conversation without needing complex forum software.

Step 4: Create a Help Page

Your wiki should have help documentation for users. Let's create one.

1. Go to http://localhost/mediawiki/index.php/Help:Editing
2. Create the page with this content:

== Editing Help ==

This page explains how to edit pages on this wiki.

== Basic Formatting ==

{| class="wikitable"
! Markup !! Result
|-
| <code><nowiki>'''bold'''</nowiki></code> || '''bold'''
|-
| <code><nowiki>''italic''</nowiki></code> || ''italic''
|-
| <code><nowiki>== Heading ==</nowiki></code> || Level-2 heading
|-
| <code><nowiki>=== Sub-heading ===</nowiki></code> || Level-3 heading
|-
| <code><nowiki>* list item</nowiki></code> || Bullet list
|-
| <code><nowiki># list item</nowiki></code> || Numbered list
|}

== Links ==

* Internal link: <code><nowiki>[[Page Name]]</nowiki></code>
* External link: <code><nowiki>[https://example.com label]</nowiki></code>
* Category: <code><nowiki>[[Category:Name]]</nowiki></code>

== Signing Messages ==

Use four tildes to sign your name: <code><nowiki>~~~~</nowiki></code>

This produces: YourUsername 12:34, 26 June 2026 (UTC)

== More Help ==

See [[Help:Contents]] for the full help documentation.

3. Write an edit summary: Created editing help page
4. Publish

Now add a link to this help page from your Main Page. Edit the Main Page and add:

[[Help:Editing|Editing Help]] — Learn how to format pages on this wiki.

Step 5: Understand How Namespace Pages Are Different

Visit Special:AllPages. This page lists every page on your wiki, organized by namespace. You'll see:

• Main namespace pages (no prefix): Project Setup Guide, API Reference, etc.
• Template namespace pages (prefixed with Template:): Note, Infobox Software
• Category namespace pages (prefixed with Category:): Development, Setup, etc.
• Help namespace pages (prefixed with Help:): Editing

Each namespace serves a different purpose and has different default permissions. For example, you can configure MediaWiki to allow anonymous users to edit the Main namespace but not the Template namespace.

What You Learned

• Namespaces organize content by type using prefixes
• Talk pages have : indentation for threaded discussions
• ~~~~ signs your name with a timestamp
• User pages are profiles for wiki members
• Help pages document how to use the wiki
• Special:AllPages shows all pages grouped by namespace

In the next lesson, you'll learn how to manage users and permissions — who can read, edit, and administer your wiki.

Common Errors

FAQ

Why do some pages have a "Talk" tab and others don't?

All pages in the Main namespace have Talk pages. Special pages (like Special:AllPages) do not — they're generated by the system and can't be edited.

Can I create custom namespaces?

Yes. You can add custom namespaces in LocalSettings.php. For example, a "Project:" namespace for project management pages:

define("NS_PROJECT", 3000);
$wgExtraNamespaces[NS_PROJECT] = "Project";
$wgExtraNamespaces[NS_PROJECT_TALK] = "Project_talk";

Custom namespaces require numbered IDs starting at 3000.

What's the difference between a Category and a Namespace?

A category is a way to GROUP related pages (a page can belong to multiple categories). A namespace is a TYPE of content (a page belongs to exactly one namespace). They serve different purposes and work together.

Should I use Help pages or articles for documentation?

Both. Help pages are for wiki usage documentation (how to edit, how to use templates). Articles are for your project's content (API docs, setup guides). The Help namespace is the right place for "how to use this wiki" content.

My signature looks different from other users' signatures

You can customize your signature in your preferences. Go to Special:Preferences → "User profile" → Signature. You can use wikitext in your signature, but keep it simple — long signatures are annoying in discussions.

What's Next

Your wiki now has all the structural pieces: pages, categories, templates, and namespaces. But right now, only you (the admin) can use it. Let's open it up to your team — safely.

Continue to Lesson 7: User Permissions & Security — learn how to manage user accounts, set permissions, and protect your wiki from spam.