Docs

What the script reads

Nodium has no form builder and puts no forms on your site. Its script finds the forms already on your pages and reads how people use them, field by field, so your page can show who saw each form, who started it, who sent it and where people stopped. It never reads what anyone types.

What it reads

For each form, once, when the script first finds it:

  • its name, from its label, a heading, its button, or its own name or id;
  • each field's label and type (email, phone, a box to tick), never what's in it;
  • which form builder made it, where it can tell.

For each visitor, under the same daily key as their pages:

  • that they saw the form, and that they started it;
  • each field they reached;
  • whether a field was empty when they pressed Send, and whether your form marked it wrong;
  • that they pressed Send, and whether your site showed the form was sent, and how.

The only thing ever read from a field is whether it's empty. Nothing is kept on the visitor's device, and nothing is sent when their browser asks not to be tracked.

What it never reads

  • What anyone types, picks or uploads.
  • Password, hidden, payment and file fields: they're skipped entirely, as are fields meant only for spam robots.
  • Anything inside a form that another website draws in a frame, beyond that it was seen and started.

How it knows a form was sent

Only your site knows whether a send went through, so Nodium counts a send when your site shows it: the form plugin's own sign, a thank-you message, a confirmation on the next page, the form replaced or emptied with no error, or the next page opening within 10 seconds of the send. Each count says which. Where none of these happens, the form is counted as seen and started, never sent.

How a send is recognised on each platform, and how sure we are
PlatformA send counts whenChecked
Contact Form 7Its own sign that the email wentProven
WPFormsIts own sign, or its confirmation on the next page (it says sent even if its email didn't go)Proven
Gravity FormsIts own sign, or its confirmation on the next pageSeen live, not sent
HubSpotIts own sign that the form was submittedSeen live, not sent
WixThe form emptying with its thank-you lineTheir docs, not proven
SquarespaceThe form replaced by its messageTheir docs, not proven
WebflowIts thank-you blockTheir docs, not proven
ShopifyThe contact page saying it was postedTheir docs, not proven
Typeform, in a frameIts own sign that the form was submittedTheir docs, not proven
Jotform, in a frameNot at all: seen and started onlyTested
Google Forms, in a frameNot at all: seen and started onlyTheir docs, not proven

“Proven” means we sent a real form and saw it counted; the others are read from the platform's own documentation or seen live without sending. Install's test send tells you for your own form.

Sign-ups

A form whose only fields are an email address, and at most a box to tick, starts as a sign-up: it's counted on its own row, not as reaching out. You can change that in Settings → Site → Your forms, where you can also rename a form so it reads well on your page, or set one aside so it isn't counted.

Testing your form

Once Nodium sees your first visit, Settings → Site lists the forms it found and offers a test: send one of your forms to yourself, the way a customer would, and Install says whether it was counted and how. If it wasn't, it says what to try. We record only which builder it was, how the send was recognised and whether it was, never anything you typed, so that recognising sends gets better.