# License Management

The theme provides a WP-CLI interface for managing theme license activation directly from the command line. This is useful for automated deployments, CI/CD pipelines, or managing licenses on staging/production environments without accessing the WordPress admin.

### Namespace

All commands are available under the `kalium license` namespace.

***

### Commands

#### Activate License

Activates the theme license using a license key.

```bash
wp kalium license activate <license-key>
```

**Arguments**

| Argument        | Description                               |
| --------------- | ----------------------------------------- |
| `<license-key>` | **Required.** The license key to activate |

**Example**

```bash
wp kalium license activate 'sk_abc123def456ghi789'
```

> **Important:** Always wrap the license key in single quotes to prevent shell escaping issues.

**Behavior**

* Validates that a license key is provided
* Checks if a license is already activated (will error if so)
* Activates the license via the Freemius SDK
* Returns success or error message

**Error Cases**

| Error                           | Description                                                         |
| ------------------------------- | ------------------------------------------------------------------- |
| `License key is required.`      | No license key was provided                                         |
| `License is already activated.` | A license is already active on this installation                    |
| `{API Error}`                   | License activation failed (invalid key, exceeded activations, etc.) |

***

#### Deactivate License

Deactivates the currently active theme license.

```bash
wp kalium license deactivate
```

**Example**

```bash
wp kalium license deactivate
```

**Behavior**

* Checks if there is an active license to deactivate
* Deactivates the license via the Freemius SDK
* Returns success or error message

**Error Cases**

| Error                                       | Description                    |
| ------------------------------------------- | ------------------------------ |
| `There is no active license to deactivate.` | No license is currently active |
| `{API Error}`                               | License deactivation failed    |

***

### Typical Workflow

#### New Installation

```bash
# Activate license on a fresh installation
wp kalium license activate 'sk_abc123def456ghi789'
```

#### Migration Between Environments

```bash
# Deactivate license on old server
wp kalium license deactivate

# Activate license on new server
wp kalium license activate 'sk_abc123def456ghi789'
```

#### CI/CD Pipeline

```bash
# Activate license during deployment (using environment variable)
wp kalium license activate "$KALIUM_LICENSE_KEY"
```

***

### Notes

* Always wrap the license key in single quotes (`'license-key'`) to prevent shell escaping issues
* Only one license can be active at a time per installation
* Deactivate your license before migrating to a new domain to free up the activation slot
* License activation requires an internet connection to communicate with the licensing server
* The license key is stored securely in the WordPress database


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.kaliumtheme.com/wp-cli-api/license-management.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.