Skip to content
demuddler

Licensing

Create a licence key, register hostnames and manage access. Read the Free, Starter and Pro limits, the licence check and the support options.

Each integration needs a licence key and the hostnames of the pages that embed the importer, on every plan, Free included. Without a valid key the importer opens no file. You manage both on Account. Install gives the first setup steps. Pricing shows the plans.

Feature Free Starter Pro
Sites 1 1 3
Rows in each export or delivery First 1,000 First 100,000 No limit
Demuddler attribution mark Shown Removed Removed
Your logo, colours and icons Yes Yes Yes
appearance.stylesheet Ignored Applied Applied
Your own text and translations Yes Yes Yes
Email support No Standard Priority

Every plan has the same parsing, mapping, checks, corrections, appearance tokens, brand, icons and messages. With messages you can replace every visible text, for example to translate the importer. Free has no time limit and needs no payment details. No plan charges for each import or each seat. See Sites for what a site is. The licence agreement gives the conditions.

The row limit applies to the source data rows of each export or delivery. Headers do not count. For example, a file has 15,000 rows. Free uses rows 1 to 1,000 and shows a limit notice. If you exclude 100 rows in that window, 900 rows remain. Free does not take more rows from later in the file. Smaller batches do not make the window larger. result.totalRows still reports 15,000.

No plan limits the number of rows that a person can open and review. Device memory and file format limits still apply on every plan. The attribution mark never enters exported data.

A site is one domain with all its subdomains. acme.com, app.acme.com, staging.acme.com and *.acme.com are one site. So one site covers the production, staging and preview hosts of a product under its own domain. The local hosts localhost and 127.0.0.1 never count.

A hostname under a shared domain, such as myapp.vercel.app or myapp.github.io, is a site of its own. Put staging and previews under your own domain, such as staging.acme.com, so that they do not use another site.

Account refuses a domain list with more sites than your plan covers. After a change to a plan with fewer sites, the licence keeps its domains, but covers only the first sites in the list. On the other sites the importer opens no file and reports domain_not_allowed.

A licence has one key, the licence key. It goes in browser code, in licenceKey or the licence-key attribute. It lets the importer open files on a registered hostname, with the plan of the licence. It is public: it works only on the hostnames that you register, so a copy on another site opens no file. You change the hostnames, and replace the key, on Account, signed in.

const importer = document.querySelector("demuddler-importer");
importer.licenceKey = "YOUR_LICENCE_KEY";

Your build system controls how the licence key gets to the browser. Set the key before a person opens a file, because a change to licenceKey starts the importer again. See Attributes and scalar properties.

Enter a hostname. Do not add a scheme, a port, a path or a trailing slash.

Licence entry Matches Does not match
app.example.com https://app.example.com/import example.com, staging.example.com
*.example.com app.example.com, preview.example.com example.com, a.b.example.com
localhost http://localhost:5173 127.0.0.1
127.0.0.1 http://127.0.0.1:5173 localhost

Matching ignores letter case and the port. A wildcard covers exactly one label. If you use the root hostname and its subdomains, register the root hostname as a separate entry.

A hostname must be a public domain: a name under a suffix of the Public Suffix List, such as .com, .co.uk or .vercel.app. Account does not accept these entries:

  • A wildcard over a shared domain, such as *.vercel.app, *.github.io or *.co.uk. Other people own sites under these domains. The Public Suffix List names them. Register each hostname instead, such as myapp.vercel.app.
  • A name that is not public, such as intranet, nas.local, app.internal, app.test or app.localhost.
  • An IP address, such as 10.0.0.5 or 8.8.8.8, and [::1].

localhost and 127.0.0.1 are the only exceptions. The licence check uses the real hostname of the parent page, not a name that your interface shows.

To test on your own computer over HTTP, register localhost or 127.0.0.1, and open your page with that name. Local tests need the licence key too.

On a local host, Starter and Pro apply in full, except that the importer ignores appearance.stylesheet, and the importer shows a Development badge in its footer. The appearance tokens still apply. No token, features flag or message can hide or rename the badge. On Free, a local host shows the attribution mark instead. The badge never enters exported data.

When the frame starts, it sends the licence key and the hostname of the parent page to the Demuddler API. It sends no cookie and nothing from the file. The browser supplies the hostname, and your page cannot change it.

A licence applies only when the frame is directly embedded in one of these pages:

  • An HTTPS page.
  • A page over HTTP on localhost or 127.0.0.1.

Every other frame opens no file. This includes an HTTP page on a LAN address and a sandboxed parent page.

The API accepts the key when all these conditions are true:

  • The key names an active licence.
  • The owner accepted the licence agreement.
  • The hostname is registered.
  • The hostname is not blocked.

The importer reads no file before the answer arrives. Until then it shows that it is starting. The frame waits at most 10 seconds for the answer.

The API signs each answer. An answer is valid only for the check that asked for it, and only for a few minutes. The frame applies a paid plan only after it checks the signature. The frame keeps only the stored answer below. These changes apply on the next frame load: the end of a paid plan, a replaced licence key, a removed hostname and a block. A frame that is already open checks its licence again every 30 minutes, and applies them at that check. If the API does not answer then, the importer keeps its plan until the stored answer below ends.

With each answer the API also signs a stored answer, which the frame keeps in the browser for that hostname. The stored answer is valid for 7 days, and never after the licence ends. The frame uses it only while the API does not answer or fails with a server error. It also uses it while the API limits the checks for the licence and hostname from all browsers together. Then the importer keeps the plan of the licence, and importer.licence.reason is unreachable. When the API limits the requests of one browser address, the frame does not use the stored answer. Then the importer opens no file, and importer.licence.reason is unreachable until a later check succeeds. A browser that has no stored answer for the hostname opens no file while the API does not answer. The frame checks again after about 30 seconds, 1 minute and 2 minutes, and then every 5 minutes. When the API answers, the open importer takes its answer without a reload and sends the licence event again.

If the API refuses the key, the importer opens no file and shows “This importer is not set up”. The frame removes its stored answer for that hostname, so a refusal applies at once. A page that stops the check from reaching the API keeps the plan of its stored answer until that answer ends. A host page cannot change the words or the look of this screen. importer.licence.reason and the licence event name the cause. See The licence is refused.

We block a hostname or an account that someone uses for fraud, phishing or another unlawful purpose. The API refuses a blocked hostname, and every name under it, for every licence. No licence can register it. The reason is domain_blocked. A blocked account cannot sign in, and the API refuses its licence keys. A block applies on the next licence check.

The licence check and the limit report contain only the licence key and the hostname. For each hostname, the service keeps two daily counts:

  • How often the importer started.
  • How often a plan row limit stopped an import.

The service deletes these counts after 35 days. Account shows the hostnames that used the key in the last 30 days, with their counts. A Free owner can receive a weekly usage email. Settings on your account turn it on or off.

To buy Starter or Pro, sign in first. Then choose the plan on your account or on Pricing. The purchase belongs to the account that you signed in with. The address that you enter at checkout does not change this.

Your plan is the plan of your subscription while it is active and paid, and Free otherwise. The plan belongs to the account, not to the licence. So when you buy, the licence key and the hostnames stay the same, and your importer gets the paid plan with no code change. A plan change in the billing portal applies on the next frame load, or within 30 minutes in a frame that is already open. Each day we compare every subscription with our payment provider and correct any difference.

A refund that ends the plan, and an open or lost payment dispute, end the paid plan at once. A renewal payment that fails ends it until the payment succeeds.

When a paid plan ends, your importer keeps opening files with the same licence key and domains, with the Demuddler mark and the Free row limit. We email you when a refund, a dispute or a failed payment ends it.

To change billing or cancel renewal, use your account and the billing portal. The billing portal opens when you have a subscription. While a subscription can still charge, for example after a failed payment, your account offers the billing portal and not a new purchase.

You sign in with a passkey, a sign-in key that your device keeps. You unlock it with your fingerprint, your face or the screen lock. Your first sign-in uses a code that we send to your email, and creates the account. Then Sign in asks you to add a passkey. Without a passkey, each sign-in uses an email code.

Security on your account manages your passkeys and sign-ins. You can add, rename and remove a passkey. You can also see the browsers that are signed in, sign out one or all of them, and read the security events of the last 90 days. We email you about each security change.

A change to your passkeys, the licence key or the sign-in email, the billing portal and deletion each need a check that it is you. Use your passkey. An account with no passkey uses a new email code instead. One check lasts for 5 minutes.

If you lose every passkey, sign in with an email code and add a new passkey. The new passkey starts to work after 24 hours, and we email you. A browser that signed in with a passkey can cancel it in that time, in Security.

In Settings on your account, you can change the sign-in email, download your account data as one JSON file and delete the account.

A new sign-in email applies when you enter the code that we send to the new address. Then we sign out your other browsers, and we tell both addresses about the change.

Deletion removes the account, its licence, domains and usage at once. An importer with its licence key then opens no file. Billing records stay where the law requires them. While a subscription can still charge, and for an hour after you open a checkout, you cannot delete the account. Cancel renewal in the billing portal. When the subscription ends, delete the account.

Start with Troubleshooting. Starter includes standard email support. Pro includes priority email support. Neither plan guarantees a response time. Send setup questions, integration questions and product errors to the email address on Privacy. Prepare a support report lists what to include and what never to send.