Page Types Overview

PageGun supports 4 page types, each designed for different content needs.

Type	Content Format	Best For
`page`	JSON sections array	Landing pages, marketing pages, product pages
`article`	Markdown	Blog posts, SEO content, news
`docs`	Markdown + navigation	Developer docs, knowledge bases, help centers
`item`	JSON data entry	Product directories, tool listings, resource collections

Choosing a Page Type

`page` — Visual Landing Pages

Build conversion-focused pages with pre-built sections (hero, features, testimonials, pricing, CTA, etc.). Content is a JSON array of section objects.

{
  "type": "page",
  "config": {
    "sections": [
      { "type": "hero", "heading": "Welcome", "ctaText": "Get Started" },
      { "type": "features", "features": [...] },
      { "type": "cta", "heading": "Ready?", "ctaText": "Sign Up" }
    ]
  }
}

Use when: You want professional design without writing HTML/CSS. All sections are mobile-responsive and optimized for conversion.

Page Type: Page →

`article` — Markdown Content

Write long-form content in Markdown. Articles support headings, lists, code blocks, images, tables, and more.

{
  "type": "article",
  "markdown_content": "# My Post\n\nContent here..."
}

Use when: You're creating blog posts, tutorials, SEO content, or any long-form writing.

Page Type: Article →

`docs` — Documentation

Build documentation with hierarchical navigation. Slug structure determines the nav tree: api-reference/authentication creates a "API Reference" folder with "Authentication" inside.

{
  "type": "docs",
  "slug": "api-reference/authentication",
  "markdown_content": "# Authentication\n\nAll requests require...",
  "config": { "sections": [] }
}

Use when: You're building developer docs, help centers, or knowledge bases with sidebar navigation.

Page Type: Docs →

`item` — Directory Entries

Structured data entries for directories. Items have custom attributes like badges, pricing, ratings, and external URLs.

{
  "type": "item",
  "config": {
    "badges": [{ "text": "Free", "color": "green" }],
    "url": "https://example.com",
    "attributes": { "Category": "AI", "Pricing": "$0" }
  }
}

Use when: You're building a tool directory, resource library, product catalog, or marketplace.

Page Type: Item →

Decision Tree

What are you building?
│
├─ Marketing / landing page → page
├─ Blog / long-form content → article
├─ Documentation / help center → docs
└─ Directory / catalog → item

Mixing Page Types

A single project can contain multiple page types. Common combinations:

Landing page + blog: page for the homepage + article for blog posts
Docs + marketing: docs for documentation + page for the docs landing page
Directory site: page with directory-hero section + item entries

API Usage

Specify the type when creating a page:

curl -X POST "https://api.pagegun.com/pages" \
  -H "Authorization: Bearer $PAGEGUN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "page_name": "My Page",
    "slug": "my-page",
    "subroute": "blog",
    "type": "article",
    "project_id": "proj_abc123",
    "markdown_content": "# Hello World"
  }'

Section Schema Reference — All section types for page pages
Guide: Building a Landing Page — Step-by-step tutorial
Guide: Building a Docs Site — Documentation setup guide

Page Types Overview

Choosing a Page Type

page — Visual Landing Pages

article — Markdown Content

docs — Documentation

item — Directory Entries