# Licensing Guide

How to activate, update, and understand EasySite Pro packages.

---

## Packages

| Package | Price (GBP) | License |
|---------|-------------|---------|
| **Basic** | £39 one-time | Not required |
| **Ultimate Bundle** | £119 one-time | Required for agency features & updates |
| **Agency Pack** | £319 one-time | 5 site activations |

Basic download is also available free from some distributors — features match Basic regardless of price paid.

---

## Activate your license (Ultimate / Agency)

1. Purchase from the license server or marketplace
2. Check email for:
   - License key (`ESITE-XXXX-XXXX-XXXX`)
   - Download link for `easysite-pro-ultimate-bundle.zip`
3. Install the theme — see [INSTALL.md](../INSTALL.md)
4. **EasySite Setup → License**
5. Paste key → **Activate**

Success message confirms activation. Agency Pack keys track activations per site URL.

---

## What the license unlocks

| Feature | Basic | Ultimate |
|---------|:-----:|:--------:|
| Visual editor | ✓ | ✓ |
| 10 core sections | ✓ | — |
| 17 sections + shop | — | ✓ |
| Client role & invite | — | ✓ |
| White-label | — | ✓ |
| Site Kit | — | ✓ |
| Section library & presets | — | ✓ |
| Demo site kits | — | ✓ |
| Remote updates | — | ✓ |

---

## Local development

When no remote license server URL is configured:

- Empty license field works on localhost
- Keys must still match `ESITE-XXXX-XXXX` format if you enter one manually

For production sites sold to clients, always activate a real key.

---

## Updates

When your distributor configures `easysite_update_url`:

1. Updates appear under **Appearance → Themes**
2. Click **Update now** on EasySite Pro Child
3. Test on staging before updating live client sites

Changelog is included in the update manifest.

---

## Deactivate / move site

1. **EasySite Setup → License**
2. Click **Deactivate**
3. Activate the same key on the new domain (if your plan allows one site)

Agency Pack: up to 5 concurrent activations. Deactivate old sites when reusing slots.

---

## Troubleshooting

| Issue | Fix |
|-------|-----|
| Invalid key format | Use `ESITE-XXXX-XXXX-XXXX` (uppercase alphanumeric) |
| Activation failed | Check site URL is reachable; confirm key not used on too many sites |
| Features locked | Confirm Ultimate zip + child theme active; re-check license |
| No updates showing | Distributor must set update URL; check license is active |

---

## For sellers

If you run your own store, see [DISTRIBUTOR.md](../DISTRIBUTOR.md) for license API, Stripe/PayPal, and update manifest setup.
