Forms

How to create a form, the field types you can use, how to put a form on a tag, why every form needs your privacy policy, and how to read the responses customers send in.

Creating a form

Forms are what customers fill in when they scan a tag: a contact form, a newsletter sign-up, a feedback survey or an event registration. You can build one from scratch or start from a ready-made template with Quick Create.

  • Open Form Manager
    Choose a business first, then open Form Manager from the main menu. Your forms are shown as cards, each with the form's name, description, how many fields it has, how many responses it has had, and its notification email.
  • For a ready-made form, click "Quick Create"
    A window opens with four template cards: "Contact Us Form", "Newsletter Signup Form", "Feedback / Survey" and "Registration / Event". Click one. The chosen card shows "Selected".
  • Type the email address for responses and click "Create"
    The "Create" button stays greyed out until a template is chosen and a proper email address is typed. The new form appears at the top of your list and "Form created successfully!" is shown. Quick Create takes one address; you can add more in the form builder afterwards.
  • For a form from scratch, click "Create Form"
    The form builder opens with an empty form. See "Adding fields to a form" below.
  • Click "Edit" on a card to change a form
    This opens the form builder for that form. A Quick Create form is a normal form: you can rename it, change its fields and change its wording here.
  • Use the three-dot menu on a card for more
    "Preview" shows the form as a customer would see it; nothing sent from a preview is kept. "Duplicate" makes a copy named "<form name> (Copy)" with the same fields, wording and notification email, and no responses. "Delete" removes the form after you confirm. Deleting cannot be undone.

Good to know

  • The four templates make forms called "Contact Us", "Newsletter Signup", "Feedback Survey" and "Event Registration". If you make the same template twice, rename one under "Form Name" in the form builder.
  • Form Manager is greyed out in the main menu until a business is selected.
  • No form can be used by customers until the business has a saved privacy policy. See "Your privacy policy" below.

Messages you might see

"No forms created yet"
You have not made any forms yet. Click "Create Form" or "Quick Create".
"Enter a valid email"
In Quick Create, the address is not complete. Check it has an @ and a dot after it.
"No business selected"
Choose a business before opening Form Manager.
"Failed to load forms"
The list could not be loaded. Refresh the page and check that a business is selected.

Adding fields to a form

The form builder is where you set the form's name, the addresses that receive responses, the wording customers see, and the fields they fill in.

  • Fill in the settings panel at the top
    It shows the form's name, or "Form Settings" for a new form, and is already open for a new form. Click it to open or close it. Fill in "Form Name", "Notification Email(s)", "Description" (shown under the title on the customer's form) and "Success Message" (shown after the customer sends the form).
  • Add a field from the "Field Types" panel
    On a desktop the panel is on the left and the form you are building is on the right under "Form Preview". Drag a field type onto the form where you want it, or click it to add it at the end. On a phone, tap "Add" to show the field types, then tap one.
  • Fill in the "Add Field" window and click "Add"
    "Name of field" is the label the customer sees. For Heading and Paragraph fields the box is labelled "Text" instead. "Field added" confirms it and the field appears on the form.
  • Change a field with the pencil on its row
    The window is headed "Edit Field". Click "Save" in the window; "Field updated" is shown. A field's type cannot be changed once it is added. To change the type, delete the field and add a new one.
  • Move a field by its handle, remove it with the bin
    Drag the handle at the left of a row to reorder. On a form that has already been saved, "Field order saved" confirms the new order straight away. The bin asks you to confirm and warns that any answers collected for that field will be removed.
  • Click "Save"
    "Form saved successfully!" confirms the form and its fields are kept. New fields and settings changes are not on the customer's form until you save.
  • Click "Preview" to check it
    The form opens as a customer would see it. Preview only works on a saved form. "Back to Form Manager" ("Back" on a phone) returns you to the list.

Good to know

  • A form must have a "Form Name" and at least one notification email before it can be saved.
  • An empty form shows "Build Your Form" with an "Add Sample Field" button, which adds a Text field called "Name" to get you going.
  • Every form automatically ends with an "I agree to the privacy policy" tick box. You do not add it and cannot remove it.
  • The settings panel has a "Form Active" switch, which is on for new forms.
  • If you leave the page with unsaved changes, a window headed "Unsaved Changes" asks whether to continue. Click "Cancel" to stay and save.

Messages you might see

"Form name is required"
Every form needs a name. Fill in "Form Name" in the settings panel.
"Form name must be less than 255 characters"
Shorten the form name.
"Description must be less than 1000 characters"
Shorten the description.
"Name is required" / "Text is required"
The field needs a name, or for Heading and Paragraph, some text.
"Field name must be unique in the form"
Two fields share the same "Field Name" under "Advanced". Change one of them.
"Please save the form before previewing."
Click "Save", then "Preview".
"Could not save field order"
The new order was not kept. Move the field again, then click "Save".
"Error saving form"
The save did not go through. Try again.

The field types

These are the kinds of field you can put on a form, and what each one looks like to a customer.

  • Text: a single line of text, such as a name or a subject.
  • Email: a single line for an email address. The customer must type a proper address.
  • Phone: a single line for a phone number.
  • Text Area: a larger box for several lines, such as a message or comments.
  • Select: a drop-down list. The customer picks one of your options.
  • Radio: your options shown as round buttons. The customer picks one.
  • Checkbox: your options shown as tick boxes. The customer can tick several.
  • Rating: a row of stars. The customer taps a star. The number of stars is the field's "Maximum Rating", five unless you change it.
  • Number: a box that only accepts numbers.
  • Date: a date, chosen from the customer's own date picker.
  • URL: a web address. It must start with "http://" or "https://".
  • Heading: bold heading text on the form. Customers read it; they do not fill it in.
  • Paragraph: a block of explanatory text. Read only, like Heading.

Good to know

  • Select, Radio and Checkbox need at least one option. In the field window, one box is shown per choice. "Add Option" adds another; the minus button removes one and is greyed out when only one is left.
  • The option boxes start as "Option 1", "Option 2" and so on. Type your real choices over them, or customers will see "Option 1".
  • A Rating field's "Maximum Rating" box says "Number of stars (1-10)".
  • Heading and Paragraph have no "Required Field" switch and no "Advanced" settings.
  • A field's type cannot be changed after it is added. Delete the field and add a new one.

Messages you might see

"Invalid field type"
A field must be one of the types the form builder offers.
"Maximum rating is required" / "Minimum rating is 1" / "Maximum rating is 10"
The star count on a Rating field must be between 1 and 10.

Required fields, placeholders and the submit button

A few settings decide what customers must fill in, what hints they see, and what the button that sends the form says and looks like.

Required fields

  • In the "Add Field" or "Edit Field" window, turn on the "Required Field" switch. The customer cannot send the form until that field is filled in. The builder shows "* Required field" under such fields, and customers see a "*" after the label.
  • Heading and Paragraph fields have no "Required Field" switch.
  • Be careful with small required fields. A required Rating with no star chosen, or a required Checkbox with nothing ticked, is enough to stop the form being sent.

Placeholders and field names

  • Click "Advanced" at the bottom left of the field window to see two more settings.
  • "Placeholder Text" is faint example text shown inside the box before the customer types.
  • "Field Name" is a short label used to identify the field, with no spaces or special characters. It is filled in for you from the field's name and you rarely need to touch it. Each field in a form must have a different one.

The submit button and thank-you message

  • "Submit Button Text" in the settings panel is the wording on the button that sends the form. It starts as "Submit".
  • "Success Message" is shown to the customer after they send the form. It starts as "Thank you for your submission!".
  • The palette icon beside "Submit Button Text" opens a window headed "Style Submit Button". Under "Button Style" choose "Filled", "Outlined", "Text" or "Rounded", and click the coloured squares to pick a "Background Color", "Text Color" or "Border Color". Click "Apply" to keep the style, then "Save" on the form. "Cancel" puts the style back to what it was when the window opened.

Messages you might see

"Submit button text must be less than 50 characters"
Shorten the button wording.
"Success message must be less than 1000 characters"
Shorten the thank-you message.
"Field label is required" / "Field label must be less than 500 characters"
Every field needs the wording shown to the customer, and it must not be too long.
"Field name is required" / "Field name must be less than 100 characters"
The "Field Name" under "Advanced" is empty or too long.
"Field name must be unique in this form"
Two fields on one form cannot share a "Field Name". Change one of them.

Your privacy policy

Forms collect customer details, so every form ends with a tick box "I agree to the privacy policy". This is where you write the policy customers read when they click that link. Until a policy has been saved for the business, customers cannot send any of its forms.

  • On Form Manager, click "Privacy Policy"
    A window headed "Privacy Policy Management" opens. You can also get here from the "Add now" button on the warning banner, or from the "Privacy Policy" button at the top of a form preview.
  • Read the fixed section
    "Data Storage & TapSpot (Fixed Section)" is marked "Cannot be modified". It is written by TapSpot and appears at the top of every business's policy.
  • Edit your own section
    Under "Your Business Privacy Policy (Editable)", a template is already filled in with sections such as "INFORMATION WE COLLECT", "HOW WE USE YOUR INFORMATION", "DATA RETENTION", "YOUR RIGHTS" and "CONTACT US". Replace the placeholders "[Your contact email]", "[Your phone number]", "[Your business address]" and "[Date]" with your own details, and change anything that does not fit your business. A counter shows how many characters you have used.
  • Check the preview
    "Complete Privacy Policy Preview" at the bottom shows the fixed section followed by yours, exactly as customers will see it.
  • Click "Save Privacy Policy"
    "Privacy policy saved successfully!" is shown and the window closes. Seeing the template in the box is not enough; the policy only counts once it is saved.

Good to know

  • There is one policy per business. All that business's forms share it.
  • The TapSpot section cannot be changed.
  • When you open Form Manager without a saved policy, a pop-up headed "Privacy Policy Required" walks through three short screens and ends with "Got It". Tick "Do not show again" to stop it. The warning banner on Form Manager stays until a policy is saved.

Messages you might see

"No privacy policy has been added for this business yet. Forms cannot be used without a privacy policy."
The banner on Form Manager. Click "Add now" and save a policy.
"No privacy policy. Forms cannot be published without one."
At the top of a form preview. Click the "Privacy Policy" button beside it.
"Privacy policy content is required" / "Business privacy policy is required"
The box is empty. The template counts as text, so this usually means it was cleared.
"Privacy policy content is too long (maximum 5000 characters)"
Shorten your section.
"A business privacy policy has not been set up yet. Please create and save your policy in TapSpot before you can submit this form."
Shown to customers under a greyed-out send button. Save a policy and the button comes back.

Notification emails

Each time a customer sends in a form, an email goes to the addresses you list on the form, so you do not have to keep checking the responses page.

  • Open the form with "Edit" and open the settings panel
    The settings panel is at the top of the form builder.
  • Type the addresses in "Notification Email(s)"
    Separate several addresses with commas, in the pattern "email1@example.com, email2@example.com".
  • Click "Save"
    The addresses are then shown on the form's card in Form Manager.

Good to know

  • Every form must have at least one notification email. The builder will not save without one.
  • Quick Create takes a single address. Add more here afterwards.
  • A duplicated form keeps the original's addresses.

Messages you might see

"Notification email is required" / "At least one notification email is required"
The box is empty. Type at least one address before saving.
"Invalid email address(es): <addresses>"
The listed entries are not proper email addresses. Check each has an @ and a dot after it, and that there is no stray comma at the end.
"No notification email"
On a form's card in Form Manager: none has been saved. Open the form with "Edit" and fill it in.

Putting a form on a tag

A tag's SmartLink can open a form directly when it is scanned. A form can also be one of the buttons on a multi-link page.

A tag that opens a form

  • Choose the Form type for the tag's SmartLink
    When you register a tag, the screen headed "Select Type of SmartLink For TS<tag number>" lists the types. Pick the form one. For a tag you already have, open the SmartLink's edit page instead.
  • Pick the form under "Select a Form"
    The list is under "Select the form that will be displayed when users scan this QR code". Forms are listed as "<form name> - <description>". A grey box then shows "Selected Form:" with the form's name, description and how many fields and responses it has.
  • No form yet? Make one first
    Click the cog beside the list, or the "FORMS.." button near the top of the page, to go to Form Manager. Come back to the tag afterwards.
  • Use "Page Settings" for the rest of the page
    Page Settings control what else shows around the form: your logo, business name, address, opening hours and the background.
  • Save the SmartLink
    Scanning the tag now opens the form.

A form button on a multi-link page

  • Open the multi-link SmartLink and click "+ ADD FORM"
    A new button is added to the page.
  • Choose the form under "Select a Form" in the button's settings
    Then save the SmartLink. When a customer taps the button, the form opens on the same page with a "Cancel" button under it. After they send it, the thank-you message shows and the form closes itself after a few seconds.

Good to know

  • A SmartLink with the Form type shows one form. Use a multi-link page for several.
  • Some SmartLink types are only available on paid plans or during a free trial. Locked types on the picker carry a note saying so.
  • The form page cannot take responses until the business has a saved privacy policy.
  • If a form that is on a tag is deleted in Form Manager, edit the tag and choose another form.

Messages you might see

"Please select a form before continuing"
A form-type SmartLink was saved without a form chosen.
"Please select a form for all form links"
A multi-link page has a form button with no form chosen.
"Please select a form first."
You tried to preview the SmartLink before choosing a form.
"No forms available"
This business has no forms yet. Make one in Form Manager.

What customers see

This is what happens when a customer scans a tag that opens one of your forms, so you know what they are looking at and what can stop them sending it.

  • The page opens
    If they are turned on in the tag's Page Settings, your logo, business name, address and opening hours appear at the top. Then comes the form in a white panel, with the form's name as the heading and its description underneath. An "Accessibility" button at the top offers text sizes "S", "M" and "L" and a "High contrast" switch; those choices are the customer's own, on their device.
  • The fields follow in the order you set
    Required fields have a "*" after their label. The last item is always the tick box "I agree to the privacy policy *". The words "privacy policy" open a window showing the TapSpot section and your own policy.
  • The send button stays greyed out until everything required is done
    It shows your Submit Button Text, or "Submit". Under it is a short note, "Protected by reCAPTCHA" (a check that stops automated spam) or "reCAPTCHA unavailable - form still works".
  • After sending, your Success Message shows in a green box
    A few seconds later the form clears, ready for another entry. On a multi-link page the form closes itself instead and the page's buttons come back. The customer cannot get the message back once it has gone.

Good to know

  • Customers do not log in. Anyone who scans the tag can fill in the form.
  • When you use "Preview", an orange banner reads "FORM PREVIEW - This form is not accepting submissions". Pressing the button shows "Form not submitted in preview mode".
  • Page Settings on the tag control the background, colours and which business details show. The form itself always sits in a white panel.
  • Your plan allows a set number of form submissions per month across the business. The number depends on your plan.

Messages customers might see

"<field name> is required"
A required field was left empty.
"Please enter a valid email address"
The Email field does not hold a proper address.
"Please enter a valid URL (starting with http:// or https://)"
The URL field is missing "http://" or "https://" at the start.
"At least one <field name> option must be selected"
A required Checkbox field has nothing ticked.
"You must agree to the privacy policy to submit the form"
The privacy policy box is not ticked.
"Form not found or not active"
The form has been deleted or switched off. Switch the form back on, or point the tag at another form.
"Form Not Available" / "This form is currently not available or has been disabled."
The tag has no usable form. Check the tag still points to a form that exists.
"This form has had all the submissions its plan allows this month. Please contact the venue another way."
This month's form submissions across the business are used up. The allowance resets next month, or you can move to a larger plan on the Billing page.
"reCAPTCHA verification failed. Please try again."
The customer did not pass the "I am not a robot" check. They should try again.
"Failed to submit form"
The entry was not sent. The customer can try again.

Reading responses

See everything customers have sent in through a form, tidy old entries away, and download the list as a spreadsheet file.

  • Click "Responses" on the form's card
    The page is headed "Form Responses" with the form's name underneath.
  • Read the two boxes at the top
    "Total Responses" is the number of active responses, with a "RESET" button. "Last Response" is the date and time of the newest, or "None". The eye icon beside it opens that response.
  • Switch between the "Active" and "Archived" tabs
    On a desktop the responses are in a table with a "Submitted" column and one column per field. On a phone each response is a card showing "Submitted:" and the first three fields, with a "Per page" chooser underneath.
  • Click the eye icon ("View" on a phone) to read a response in full
    A window headed "Response Details" shows each field with the customer's answer, or "No response" if they left it empty.
  • Click "Export CSV" to download the list
    You get a CSV file, which opens in Excel or similar, with a "Submitted At" column and one column per field. It is named after the form. Only active responses are included; archive responses first to leave them out. The button is greyed out when there are no active responses.

Archiving, restoring and deleting

  • To put one response away, click its archive icon ("Archive" on a phone) and confirm. To archive several, tick them (or "Select All") and click "Archive". To archive everything, click "RESET" under "Total Responses" and confirm with "Archive All".
  • Archiving is reversible. "RESET" only archives; it does not delete anything. "Total Responses" counts active responses only.
  • On the "Archived" tab each row has a view icon, a restore icon and a delete-forever icon. Tick rows for "Restore" or "Delete" in bulk.
  • "Delete Forever" is permanent and is only offered on the Archived tab. The window warns "This cannot be undone."
  • "Refresh" reloads the list. "Back to Form Manager" returns you to your forms.

Messages you might see

"No responses yet"
Nobody has sent the form in yet.
"No archived responses"
Nothing has been archived.
"Responses exported successfully!"
The file has been downloaded.
"You do not have permission to view these responses"
The form belongs to a business you cannot see. Check which business is selected.
"Failed to load responses" / "Failed to export responses"
Click "Refresh" and try again.

Problems and what to check

  • Customers say the send button is greyed out: a required field is empty or the privacy policy box is not ticked. Look for small required fields such as a Rating or a Checkbox. If the message under the button mentions a privacy policy, no policy has been saved: open "Privacy Policy" on Form Manager and click "Save Privacy Policy".
  • Notification emails are not arriving: check the address on the form's card, then your spam folder, then open "Responses" for the form. If responses are listed there but no email came, the problem is with the address or your mailbox, not the form.
  • Only one person gets the emails: add the other addresses in "Notification Email(s)", separated by commas, and click "Save".
  • A field you added is not on the customer's form: the form was not saved after adding it. Open it with "Edit" and click "Save".
  • "Preview" only shows "Please save the form before previewing.": click "Save" first.
  • You cannot see the field types on a phone: tap "Add" at the top of the form.
  • A Select or Radio field shows "Option 1" to customers: the default option names were left in. Click the field's pencil and type your real choices.
  • The wrong form opens from a tag: edit the SmartLink and check "Select a Form".
  • A form has disappeared from a tag: it may have been deleted in Form Manager. Edit the tag and choose another form.
  • The policy still shows "[Your contact email]" to customers: the placeholders in the template were not replaced. Edit the policy and save again.
  • The "Privacy Policy Required" pop-up keeps appearing: save a policy, or tick "Do not show again" before clicking "Got It".
  • A response is missing: look on the "Archived" tab and restore it if needed. The exported file leaves out archived responses too.
  • A column is empty for every response: the field was added after those responses came in.
  • A message says you do not have permission: check which business you are working in; you may be in the wrong one.

Still stuck? Email support@tapspot.link and tell us which screen you were on.