The free n8n Community Edition license key unlocks several useful features in your self-hosted n8n instance, including workflow history, editor debugging, folders, and execution search. This guide walks you through requesting the key, activating it, and resolving the most common issues you may run into along the way.

What the license key unlocks

The free Community Edition license is more than a formality. Once activated, it enables the following features at no cost:

  • Workflow history — a chronological log of changes to your workflows, so you can track edits and revert to earlier versions.
  • Editor debugging — copy and pin execution data to inspect node inputs and outputs while building.
  • Folders — organise your workflows into a structured, navigable library.
  • Execution search — search past executions by various criteria to quickly locate and diagnose specific runs.

Step 1: Open the Usage and Plan page

  1. Log in to your self-hosted n8n instance.
  2. Click the three-dot Options menu in the lower-left corner of the screen.
  3. Select Settings.
  4. Open Usage and plan.

Step 2: Request your free license key

  1. On the Usage and plan page, click Unlock selected paid features for free (sometimes shown simply as Unlock).
  2. Enter an email address you actively monitor — this is where your key will be sent.
  3. Confirm the request. n8n displays a message confirming the key is on its way.

Step 3: Activate your license key

Check your email for a message from n8n containing your license key and an activation link.

  • Easiest method: click the activation link in the email. This registers the key with your n8n instance automatically.
  • Manual method: if the link does not work, copy the license key from the email, return to Settings > Usage and plan, choose Enter activation key, paste the key, and click Activate.

When pasting the key manually, make sure you copy the entire key with no leading or trailing spaces.

Common issues and how to fix them

The "Usage and plan" menu is missing

If the Usage and plan menu does not appear, it is usually because the N8N_HIDE_USAGE_PAGE environment variable is set to true in your deployment configuration (for example, your Docker Compose file or Kubernetes deployment). Set it to false and restart your n8n instance for the menu to reappear.

The license key email never arrives

Email filtering for automated messages can be unpredictable. Check your Spam, Junk, Promotions, and Updates folders as well as your main inbox. If several hours pass with no email, request the key again. For self-hosted instances, confirm your server is configured to send outbound email and is not blocking external communications. If the problem persists, contact n8n support, as the issue may be with their email delivery.

Features stay locked after activation

This is usually a caching issue. After activating, restart your n8n instance, then clear your browser cache or perform a hard refresh (Ctrl+F5 on Windows, or Cmd+Shift+R on Mac) so the UI loads its latest state. For more detail, see our article on the "activation key already used" error.

"Activation key has already been used" error

Seeing this message while features remain locked usually points to a lingering state or caching problem. Restart your n8n instance and clear your browser cache first. If features are still unavailable afterwards, refer to our dedicated "Activation key already used" article for further troubleshooting.

Timeout errors or "wrong format" messages

For timeout errors, regenerate the key from the Usage and plan section and try again. If the key is reported as the wrong format, re-copy the full key without any extra spaces or characters. Restarting the instance and clearing your browser cache resolves most transient glitches of this kind.

Error 429 (too many requests)

If you hit an Error 429 while requesting or activating your key, you have made too many requests in a short period. Wait a short while before trying again. See our dedicated Error 429 article for full details on what causes this and how to resolve it.

Need a hand?

If you are still stuck after working through the steps above, contact our team at hello@awesomate.ai and we will help you get set up.