> ## Documentation Index
> Fetch the complete documentation index at: https://docs.areawp.com/llms.txt
> Use this file to discover all available pages before exploring further.

# WordPress

> Deploy and manage WordPress sites — grid or table view, one-click WP Admin login, domain validation, and site templates.

<Info>
  **Path:** WordPress (`/wordpress`)

  The WordPress page lists all deployed sites and is the starting point for creating new ones. Sub-section: WP Pipeline (`/wordpress/projects`) — available when a Git integration is configured.
</Info>

## Site List

Sites are displayed in your choice of layout:

<Tabs>
  <Tab title="Grid View">
    Cards showing site name, URL, a color-coded status dot, WordPress version, environment count, and (for admins) the owning user. Quick-access buttons: **Visit Site** and **WordPress Admin**.
  </Tab>

  <Tab title="Table View">
    Same data in rows — useful for scanning many sites. Columns: Name, Domain, Status, WP Version, Environments, Owner (admin), Actions.
  </Tab>
</Tabs>

### Status Indicator

| Status     | Meaning                              |
| ---------- | ------------------------------------ |
| 🟢 Running | Container is up and serving requests |
| 🔴 Stopped | Container is stopped                 |

***

## Creating a Site

Click the **Create Site** button to open the creation modal.

| Field           | Description                                            |
| --------------- | ------------------------------------------------------ |
| **Site Name**   | Display name for the site                              |
| **Domain**      | Primary domain — checked for availability in real time |
| **Admin Email** | WordPress admin account email                          |
| **User**        | Assign the site to a specific client (admin only)      |

### Domain Validation

As you type the domain, AreaWP checks availability and shows:

* 🔄 Checking...
* ✅ Available
* ❌ Already taken
* ⚠️ Invalid format

If a default domain is configured, a subdomain is auto-suggested based on the site name.

### License & Plan Checks

If the user has no active subscription, has reached their plan's site limit, or there's a license issue, a contextual alert appears before the creation form — with a direct link to fix the underlying problem.

***

## Site Actions

From the grid or table, each site has two quick-action buttons:

| Button              | Action                                                                     |
| ------------------- | -------------------------------------------------------------------------- |
| **Visit Site**      | Opens the live domain in a new tab                                         |
| **WordPress Admin** | Opens the WP Admin dashboard with auto-login (disabled if site is stopped) |

***

## WP Pipeline

**Path:** `/wordpress/projects`

<Info>
  WP Pipeline is available when the built-in Gitea integration is configured (see [Git](/infrastructure/git)).
</Info>

The WP Pipeline provides a Git-based deployment workflow for WordPress projects:

* Connect a repository to a WordPress site
* Define environments (staging, production)
* Push to a branch to trigger an automatic deployment
* Configure pre and post-deploy hooks (WP-CLI commands, cache flush, etc.)
* View deployment history and roll back with one click