GitHub|Since 2007
Documentation

Pages Management Overview

Pages Management Overview

Understanding Pages in Headless WordPress

The Pages section is where you create and manage static content pages that serve specific purposes on your site.

Two Types of Pages

As shown in the screenshot, there are two distinct tabs:

1. Next.js Pages (Custom Pages)

What are these? Pages you create directly in the Next.js frontend. These are fully custom, built with your design system and React components.

Use cases:

  • Landing pages with custom layouts and interactive elements
  • About Us with team member cards and company timeline
  • Services/Products pages with pricing calculators
  • Portfolio/Gallery with custom filtering
  • Contact with embedded maps and forms

Advantages:

  • Complete design freedom
  • Can include interactive JavaScript features
  • Lightning-fast page load times
  • SEO-optimized at build time

When the list is empty: You'll see 'No custom pages yet. Create one to get started!' This is normal for new installs.

2. WordPress Pages

What are these? Pages created in your WordPress admin panel that are automatically fetched and rendered by the headless system.

Use cases:

  • Standard content pages managed by non-technical staff
  • Legal pages (Privacy Policy, Terms of Service)
  • FAQ and Help documentation
  • Simple informational pages

Advantages:

  • Easy content updates through WordPress editor
  • No coding required
  • Familiar interface for content teams
  • Content reusability

Creating a New Next.js Page

Click the blue '+ Add New Page' button to create a custom page.

What happens next:

  1. You'll enter a page title (e.g., 'Landing Page', 'About Us')
  2. You'll specify a slug (URL path, e.g., 'landing-page')
  3. You'll have access to a content editor
  4. You can build the page using section blocks

Page vs Post: What's the Difference?

Pages:

  • Timeless content that doesn't change often
  • Not organized by date
  • Not included in blog feeds
  • Accessed via main navigation
  • Examples: About, Contact, Services

Posts (Blog):

  • Time-sensitive, dated content
  • Organized chronologically
  • Appear in blog listings and RSS feeds
  • Have categories and tags
  • Examples: News, Articles, Updates