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

# Activating License

> How to activate your Koala Data Explorer license after purchase

## Overview

After your 7-day free trial ends and you decide to continue with Koala Data Explorer, you'll need to activate your paid license. This guide walks you through the activation process.

## Automatic Activation

In most cases, your license activates automatically:

1. **Trial ends** after 7 days
2. **Payment processed** via LemonSqueezy
3. **License activated** automatically in VS Code
4. **Full features unlocked** immediately

You should see a notification in VS Code confirming your license activation.

## Manual Activation

If automatic activation doesn't work, follow these steps:

### Step 1: Locate Your License Key

1. **Check your email** for the purchase confirmation
2. **Visit LemonSqueezy portal**: [My Orders](https://app.lemonsqueezy.com/my-orders/)
3. **Find your order** and copy the license key

### Step 2: Enter License in Extension

1. **Open Koala Data Explorer** in VS Code
2. **Click the Settings gear** in the extension toolbar
3. **Select "License Settings"**
4. **Paste your license key** in the provided field
5. **Click "Activate License"**

### Step 3: Verify Activation

After activation, you should see:

* ✅ **License status**: "Active" in settings
* ✅ **Premium features**: All features unlocked
* ✅ **No row limits**: Unlimited query results
* ✅ **Excel export**: Available in results panel

## License Features

### Free Mode (Trial/Unlicensed)

* Single query tab
* Basic authentication only
* 50 rows per query limit
* CSV/JSON export only
* Basic SQL history

### Licensed Mode (Paid)

* Unlimited query tabs
* OAuth PKCE and Windows SSO authentication
* Unlimited rows
* Excel export
* Data sources explorer
* IntelliSense autocomplete
* Performance monitor
* Extended SQL history

## Troubleshooting Activation

### License Key Not Working

**Check these common issues:**

1. **Correct key**: Ensure you copied the full license key
2. **No extra spaces**: Remove any leading/trailing spaces
3. **Active subscription**: Verify your subscription is current
4. **Internet connection**: License validation requires internet access

### Still Not Activating?

**Try these steps:**

1. **Restart VS Code** completely
2. **Clear extension cache**:
   * Close VS Code
   * Clear VS Code workspace state (if needed)
   * Reopen and try activation again
3. **Check subscription status** in [LemonSqueezy portal](https://app.lemonsqueezy.com/my-orders/)

### Contact Support

If activation still fails:

* **Support Portal**: [Submit a ticket](https://btsscorp.freshdesk.com/support/tickets/new)
* **Email**: [support@btsscorp.com](mailto:support@btsscorp.com)
* **Include**:
  * Your order number
  * License key (last 4 characters only)
  * Error messages or screenshots
  * VS Code version

## License Management

### Checking License Status

To view your current license status:

1. **Open Koala Data Explorer**
2. **Click Settings gear** → **License Settings**
3. **View license information**:
   * Status (Active/Inactive)
   * Expiration date
   * Features included

### Multiple Devices

Your license allows installation on:

* **Multiple devices** for the same user
* **Development and personal use**
* **Not for team sharing** (each user needs a license)

### License Renewal

Licenses are subscription-based:

* **Automatic renewal** through LemonSqueezy
* **Email reminders** before expiration
* **Grace period** for payment issues
* **Reactivation** available after payment resolution

## Subscription Management

### Updating Payment Method

1. **Visit** [LemonSqueezy customer portal](https://app.lemonsqueezy.com/my-orders/)
2. **Find your subscription**
3. **Update payment details**
4. **Save changes**

### Canceling Subscription

1. **Visit** [LemonSqueezy customer portal](https://app.lemonsqueezy.com/my-orders/)
2. **Find your subscription**
3. **Cancel subscription**
4. **Access continues** until current period ends

## Frequently Asked Questions

### Q: Can I use my license on multiple computers?

A: Yes, you can install on multiple devices for your personal use.

### Q: What happens if my subscription expires?

A: The extension reverts to free mode with basic features only.

### Q: Can I transfer my license to another user?

A: No, licenses are non-transferable between users.

### Q: Do I need internet for license validation?

A: Yes, initial activation and periodic validation require internet access.

### Q: Can I downgrade from paid to free?

A: Yes, cancel your subscription and the extension will revert to free mode.

## Getting Help

Need assistance with license activation?

* **Documentation**: Check our [troubleshooting guides](/koala/troubleshooting/connection-issues)
* **Support Portal**: [Submit a ticket](https://btsscorp.freshdesk.com/support/tickets/new)
* **Email**: [support@btsscorp.com](mailto:support@btsscorp.com)
* **Response Time**: 24-48 hours

We're here to ensure your activation goes smoothly!