This guide teaches you how to add a new page in WordPress theme using built-in tools or custom code. Whether you’re a beginner or developer, you’ll find clear steps to create pages that match your site’s design and functionality.

Key Takeaways

• Use the WordPress admin dashboard to quickly create and publish new pages without touching any code.
• Custom page templates let you design unique layouts for specific pages like About, Services, or Landing pages.
• Child themes are essential when modifying theme files to avoid losing changes during updates.
• Flush permalinks if your new page shows a 404 error after creation.
• Use plugins like Elementor for drag-and-drop page building without coding.
• Always back up your site before making changes to theme files.

Introduction: Why Adding Pages Matters in WordPress

WordPress powers over 40% of all websites on the internet, and one of its greatest strengths is flexibility. Whether you’re running a blog, business site, or online store, adding new pages is a routine task. Knowing how to add a new page in WordPress theme helps you grow your site, improve navigation, and deliver better user experiences.

In this guide, you’ll learn multiple methods—from simple admin tools to advanced template creation. We’ll cover everything you need, whether you’re a beginner using the visual editor or a developer building custom layouts. By the end, you’ll be able to add pages confidently and keep your site looking professional.

Method 1: Adding a Page via the WordPress Admin Dashboard

The easiest and most common way to add a new page is through the WordPress admin area. This method requires no coding and works with any theme.

Visual guide about How to Add New Page in WordPress Theme

Image source: testingdocs.com

Step 1: Log in to Your WordPress Admin

Go to yoursite.com/wp-admin and log in with your username and password. Once logged in, you’ll see the WordPress dashboard.

Step 2: Navigate to Pages

In the left-hand menu, click on Pages, then select Add New. This opens the WordPress block editor (Gutenberg).

Step 3: Enter Page Title and Content

Type your page title at the top (e.g., “About Us” or “Contact”). Below, use blocks to add text, images, buttons, or videos. For example, add a “Paragraph” block for text or an “Image” block to upload a photo.

Step 4: Set Page Attributes (Optional)

On the right sidebar, under Page Attributes, you can:

• Choose a Parent Page to create a subpage (e.g., “Team” under “About”).
• Select a Template if your theme offers custom templates (we’ll cover this later).

Step 5: Publish the Page

Click the Publish button in the top-right corner. Your page is now live! Visit your site and navigate to the new page to confirm it’s working.

Tip: Use the “Preview” button to see how the page looks before publishing.

Method 2: Creating a Custom Page Template

If you want a unique layout—like a full-width landing page or a portfolio grid—you’ll need a custom page template. This method involves editing theme files, so proceed with caution.

Visual guide about How to Add New Page in WordPress Theme

Image source: wildflowersandpixels.co.uk

Step 1: Use a Child Theme

Never edit your main theme files directly. Instead, use a child theme to preserve changes during updates. If you don’t have one, learn what a child theme is in WordPress and how to create it.

Step 2: Create a New Template File

In your child theme folder, create a new PHP file. Name it something descriptive, like page-landing.php.

Step 3: Add Template Header

At the top of the file, include this code:

This tells WordPress this file is a page template named “Landing Page.”

Step 4: Build the Template

Add HTML and PHP to design your layout. For example:

  
Welcome to Our Site
  
Your journey starts here.
  Get Started

This creates a simple hero section. You can add CSS in your child theme’s style.css file to style it.

Step 5: Assign the Template to a Page

Go back to the WordPress admin, create a new page, and in the Page Attributes section, select “Landing Page” from the Template dropdown. Publish the page.

Tip: Use get_template_part() to include reusable sections like testimonials or features.

Method 3: Using a Page Builder Plugin

For users who prefer visual design, page builders like Elementor, Beaver Builder, or Divi make adding pages fast and flexible.

Visual guide about How to Add New Page in WordPress Theme

Image source: wildflowersandpixels.co.uk

Step 1: Install a Page Builder

Go to Plugins > Add New, search for “Elementor,” and click Install Now, then Activate.

Step 2: Create a New Page

Go to Pages > Add New, enter a title, and click Edit with Elementor.

Step 3: Design with Drag-and-Drop

Use Elementor’s widgets to add headings, images, forms, and more. You can choose from pre-designed templates or build from scratch. For example, select a “Landing Page” template and customize it.

Step 4: Publish

Click Update or Publish when done. Your page will use the builder’s design while still working within your theme.

Tip: Learn how to create a WordPress theme with Elementor for full control over design.

Method 4: Adding Pages Programmatically

Developers can add pages automatically using PHP. This is useful for plugins or theme setup.

Step 1: Use wp_insert_post()

Add this code to your theme’s functions.php file (preferably in a child theme):

function create_custom_page() {
  $page = array(
    'post_title'    => 'Custom Page',
    'post_content'  => 'This page was created programmatically.',
    'post_status'   => 'publish',
    'post_type'     => 'page'
  );
  wp_insert_post($page);
}
add_action('after_setup_theme', 'create_custom_page');

This creates a page titled “Custom Page” when the theme is activated.

Step 2: Prevent Duplicates

To avoid creating the same page multiple times, check if it exists first:

if (!get_page_by_title('Custom Page')) {
  wp_insert_post($page);
}

Warning: Remove or comment out the code after the first run to prevent repeated page creation.

Troubleshooting Common Issues

Even with careful steps, you might run into problems. Here’s how to fix them.

Page Shows 404 Error

If your new page returns a 404, the permalink structure may need refreshing. Go to Settings > Permalinks and click Save Changes (no need to change anything). This flushes the rewrite rules.

Template Not Appearing in Dropdown

If your custom template doesn’t show up, ensure:

• The file is in the active theme (or child theme) folder.
• The Template Name comment is correct.
• There are no syntax errors in the PHP file.

Changes Not Reflecting

Clear your browser cache and any caching plugins. If using a CDN, purge its cache too.

White Screen or PHP Error

This usually means a syntax error in your code. Check your PHP file for missing semicolons or brackets. Restore from backup if needed.

Best Practices for Adding Pages

Follow these tips to keep your site organized and secure:

• Use descriptive page titles for better SEO and user experience.
• Optimize images before uploading to improve page speed.
• Test on mobile to ensure responsiveness.
• Back up your site before making code changes. Use plugins like UpdraftPlus.
• Update your theme safely by learning how to update a theme on WordPress without breaking your site.

Conclusion: Choose the Right Method for Your Needs

Adding a new page in WordPress doesn’t have to be complicated. For most users, the admin dashboard is the fastest and safest option. Designers and developers can use custom templates or page builders for advanced layouts. Always use a child theme when modifying files, and remember to test your changes.

Whether you’re adding a simple contact page or a complex landing page, WordPress gives you the tools to do it right. Now that you know how to add a new page in WordPress theme, you can expand your site with confidence.