Put it on a live site

The editor is free while you build. Once it's on a live site, it needs a license key from one of the plans. Without one it still works, with a thin "Unlicensed Mastershot editor" line above it. Nothing your visitors do is ever blocked.

Where your key comes from

After you buy a plan, Polar shows your key and emails it to you. It starts with MSE-. You can find it again any time in Polar's customer portal by signing in with the email you bought with.

Where the key goes

Pass it as licenseKey when you make the editor:

appendDefaultEditor("#editor", {
  licenseKey: "MSE-XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
})

Or as the element's attribute:

<mastershot-editor
  license-key="MSE-XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX"
></mastershot-editor>

The same works with openDefaultEditor, appendDefaultEditors and processImage. The key sits in your page's code where anyone can read it, and that's fine: it only covers your domains.

Paste your key on the start page to check it and get this code with your key already in it.

How domains are counted

You don't list your domains anywhere. The first time the editor runs on a domain with your key, that domain is added to the key, until it has as many as your plan covers: 2 for Indie, 5 for Business, and any number for Enterprise.

• www.example.com and example.com count as one domain. shop.example.com is its own.
• Localhost, private network addresses, and names ending in .test, .local, .localhost, .example, .invalid and .internal never need a key and never count.
• A staging site on its own public domain does count, so put it on a free name or a subdomain you don't mind using a place on.

The start page shows which domains your key is on. To move a key to a different domain, email [email protected] and we'll free its place.

When a subscription ends

Every version released while your subscription was active keeps working on your domains, without the unlicensed line, for as long as you use it. Versions released after it ended show the line until you subscribe again.

If the line shows up

Open your browser's console on the page. The editor says why there:

• "needs a license key": the page didn't pass licenseKey, or passed an empty one.
• "the license key isn't valid, or its subscription has ended": check the key on the start page. It says whether Polar knows it, and whether it has ended.
• "in use on as many domains as it covers": the key's places are taken by other domains. The start page lists them.

The editor checks the key with mastershot.app once an hour at most. If that check can't be made for any reason, the editor counts as licensed.