This guide shows you how to add a page in WordPress theme using built-in tools or custom code. Whether you’re using the Block Editor or creating a custom template, you’ll find clear, beginner-friendly instructions.

Key Takeaways

• Use the WordPress Dashboard: The easiest way to add a page is through the Pages menu in your admin panel.
• Choose the Right Editor: Use the Block Editor (Gutenberg) for drag-and-drop layouts or switch to the Classic Editor if preferred.
• Create Custom Page Templates: For unique designs, create a custom template file in your theme folder.
• Assign Templates to Pages: After creating a template, assign it to any page via the Page Attributes panel.
• Use Child Themes for Safety: Always use a child theme when modifying theme files to avoid losing changes during updates.
• Flush Permalinks if Needed: If your new page doesn’t load, reset permalinks in Settings > Permalinks.
• Test on Staging First: Try new templates or code on a staging site before going live.

How to Add a Page in WordPress Theme

Adding a page in WordPress is one of the most common tasks for website owners. Whether you’re building a blog, business site, or portfolio, pages help organize your content. In this guide, you’ll learn how to add a page in WordPress theme using both built-in tools and custom development methods. We’ll cover everything from the basics to advanced customization—perfect for beginners and intermediate users alike.

WordPress makes it simple to create pages without touching code. But sometimes, you’ll want more control over layout and design. That’s where custom page templates come in. We’ll walk you through both approaches so you can choose what works best for your site.

Method 1: Adding a Page Using the WordPress Dashboard

This is the easiest and most recommended way for beginners. You don’t need to edit any files or write code.

Step 1: Log in to Your WordPress Admin

Go to your website’s login page (usually yoursite.com/wp-admin) and enter your username and password.

Step 2: Navigate to Pages

In the left-hand menu, click on Pages, then select Add New.

Step 3: Enter Your Page Title and Content

Type your page title (e.g., “About Us” or “Contact”) in the title field. Use the editor below to add text, images, videos, or blocks like buttons and columns.

Step 4: Set Page Attributes (Optional)

On the right side, you’ll see the Page Attributes panel. Here you can:

• Choose a Parent Page if this is a subpage.
• Select a Template (if your theme offers custom templates).
• Set the Order number to control display sequence.

Step 5: Publish Your Page

When you’re ready, click the Publish button. Your page will go live immediately.

Pro Tip: Use the “Preview” button to see how your page looks before publishing. This helps catch formatting issues early.

Method 2: Creating a Custom Page Template

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

Step 1: Use a Child Theme

Never edit your main theme files directly. Instead, use a child theme. This protects your changes when the parent theme updates. If you don’t have one, learn what is a child theme in WordPress and how to set it up.

Step 2: Create a New Template File

Open your child theme folder (via FTP or your hosting file manager). Create a new PHP file, such as page-landing.php.

Step 3: Add Template Header

At the top of the file, add this code:



This tells WordPress it’s a page template named “Landing Page.”

Step 4: Build Your Template

Below the header, add your HTML and PHP. For example:



Welcome to Our Site

This is a custom landing page.

Visual guide about How to Add Page in WordPress Theme

Image source: s3.envato.com

Visual guide about How to Add Page in WordPress Theme

Image source: hogash.com



You can include custom CSS by linking to a stylesheet or using inline styles.

Step 5: Upload and Assign the Template

Save the file and upload it to your child theme folder. Now, when you create a new page in WordPress, you’ll see “Landing Page” in the Template dropdown under Page Attributes.

Example: A client wanted a full-width contact page without sidebars. We created a page-contact-fullwidth.php template that removed the sidebar and used a wider content area.

Method 3: Using a Page Builder Plugin

Visual guide about How to Add Page in WordPress Theme

Image source: s.tmimgcdn.com

Plugins like Elementor, Beaver Builder, or Divi make it easy to design pages visually—no coding needed.

Step 1: Install a Page Builder

Go to Plugins > Add New, search for “Elementor,” and install it. Activate the plugin.

Step 2: Create a New Page

Go to Pages > Add New, enter a title, then click “Edit with Elementor.”

Step 3: Design Your Page

Use drag-and-drop widgets to add headings, images, forms, and more. You can save your design as a template for reuse.

Step 4: Publish

Click “Publish” when done. The page will appear on your site with your custom design.

Tip: Many page builders support global styles and responsive editing, so your page looks great on mobile and desktop.

Troubleshooting Common Issues

Even with simple steps, things can go wrong. Here’s how to fix common problems.

Page Not Showing Up?

If your new page doesn’t appear, try refreshing your permalinks:

• Go to Settings > Permalinks.
• Click “Save Changes” (no need to change anything).

This resets the URL structure and often fixes missing pages.

Template Not Appearing in Dropdown?

Make sure:

• The template file is in your active theme (or child theme) folder.
• The Template Name comment is correct and at the top.
• You’ve refreshed the page editor.

Changes Not Saving?

Check file permissions. Your theme files should be writable (644 for files, 755 for folders). Also, clear your browser and WordPress cache.

White Screen or Error?

This usually means a PHP error in your template. Check for missing semicolons, brackets, or typos. Use a tool like WP Debug to find the issue.

Best Practices for Adding Pages

To keep your site fast, secure, and easy to manage, follow these tips:

• Use Descriptive Titles: Help users and search engines understand your page content.
• Optimize for SEO: Add meta titles, descriptions, and alt text to images. Consider using a plugin like Yoast SEO.
• Keep URLs Clean: Use short, keyword-rich URLs (e.g., yoursite.com/about instead of yoursite.com/page?id=123).
• Test Responsiveness: Make sure your page looks good on phones and tablets.
• Backup Regularly: Before making major changes, back up your site. Use plugins like UpdraftPlus.

Conclusion

Learning how to add a page in WordPress theme opens up endless possibilities for your website. Whether you use the built-in editor, create custom templates, or leverage page builders, WordPress gives you the tools to build exactly what you need.

Start simple with the dashboard method, then explore custom templates as your skills grow. Always use a child theme to protect your work, and test changes on a staging site when possible. With these steps, you’ll be creating beautiful, functional pages in no time.

For more advanced customization, check out our guide on how to create a WordPress theme with Elementor. And if you’re managing multiple themes, learn how to set a default theme in WordPress to avoid confusion.