> ## 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.

# Settings

> Platform-wide configuration hub with 17 categories — profile, security, appearance, white-label, email, integrations, licensing, and more.

<Info>
  **Path:** Administration → Settings (`/settings`) — Admin only

  Settings uses a left sidebar navigation to switch between categories. Changes in most tabs take effect immediately on save.
</Info>

## Settings Categories

| Category           | What You Configure                               |
| ------------------ | ------------------------------------------------ |
| **Profile**        | Account name, email, password                    |
| **Security**       | 2FA, session timeout, login policy, allowed IPs  |
| **Appearance**     | Dashboard theme, colors                          |
| **Languages**      | UI language, timezone, date format               |
| **Sidebar**        | Default sidebar preset for all users             |
| **White Label**    | Brand name, logo, favicon, primary color         |
| **Notifications**  | Email/Slack/webhook alert routing                |
| **Site Settings**  | Default domain, registration, platform mode      |
| **Integrations**   | Cloud provider API keys, third-party connections |
| **Email**          | SMTP configuration and email templates           |
| **Privacy / GDPR** | Cookie policy, data retention, privacy settings  |
| **SSO**            | OAuth/SAML single sign-on providers              |
| **API**            | API key management for external integrations     |
| **Migration**      | Import/export history and tools                  |
| **System Info**    | Server specs, versions, environment details      |
| **Licensing**      | License key validation and status                |

***

## White Label

Make the platform your own:

| Setting               | Description                                                   |
| --------------------- | ------------------------------------------------------------- |
| **Brand Name**        | Replaces "AreaWP" throughout the UI                           |
| **Logo (light mode)** | SVG or PNG, recommended 200×50px                              |
| **Logo (dark mode)**  | Dark-mode variant                                             |
| **Favicon**           | 32×32 ICO or PNG                                              |
| **Mode**              | `Text only` — replace text; `Full logo` — replace logo + text |
| **Primary Color**     | Main accent color (hex)                                       |
| **Support URL**       | Link shown in the sidebar support link                        |
| **Hide Version**      | Remove version numbers from the footer                        |

***

## Email (SMTP)

| Field          | Description                   |
| -------------- | ----------------------------- |
| **SMTP Host**  | Mail server hostname          |
| **SMTP Port**  | 587 (STARTTLS) or 465 (SMTPS) |
| **Username**   | SMTP auth username            |
| **Password**   | SMTP auth password            |
| **From Email** | Sender address                |
| **From Name**  | Sender display name           |

Click **Send Test Email** after saving to verify the configuration.

### Email Templates

Customize the content and branding of platform emails — welcome, verification, password reset, invoice, renewal reminder, payment failed, cancellation, backup complete/failed.

***

## Security

| Setting                    | Default            |
| -------------------------- | ------------------ |
| **Enforce 2FA for Admins** | Off                |
| **Session Timeout**        | 120 minutes        |
| **Max Login Attempts**     | 5                  |
| **Password Policy**        | Medium             |
| **API Rate Limit**         | 100 req/min per IP |
| **Allowed IP Ranges**      | Any                |

***

## Licensing

| Field           | Description                        |
| --------------- | ---------------------------------- |
| **License Key** | Your AreaWP license key            |
| **Status**      | Active / Suspended / Expired       |
| **Domain**      | Registered domain for this license |
| **Plan**        | License tier                       |
| **Max Sites**   | Site limit from your license       |
| **Expires**     | License expiry date                |

Click **Validate License** to force a fresh check against the license server. Useful after purchase, renewal, or domain change.

<Info>
  License validation runs automatically every 6 hours. If the server is offline, the cached result is valid for up to 14 days.
</Info>

***

## Integrations

Connect cloud providers to enable VPS provisioning from **Servers → Cloud**:

| Provider     | Credential            |
| ------------ | --------------------- |
| DigitalOcean | Personal Access Token |
| Hetzner      | API Token             |
| Vultr        | API Key               |
| Linode       | Personal Access Token |

***

## SSO

Configure single sign-on for admin and user accounts:

* **OAuth providers** — GitHub, Google, Microsoft
* **SAML** — enterprise identity providers

Each provider requires a client ID, client secret, and callback URL configuration on the provider side.