Skip to main content

​
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
  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

​
Contact Support

If activation still fails:

​
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
  2. Find your subscription
  3. Update payment details
  4. Save changes

​
Canceling Subscription

  1. Visit LemonSqueezy customer portal
  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? We’re here to ensure your activation goes smoothly!