Kanorio

Online Forms

About 7 minBeginner

If you want visitors to contact you, book a slot, or sign up for an event, you can add an online form to your website. This guide explains how to create a form, add it to your pages, and view or organize the responses you receive.

Forms are available on all plans. For details on whether to send automated confirmation emails to visitors or notify your team, see Form Confirmations.

Create a form

  1. Go to Marketing › Online Forms in your dashboard.
  2. Click "Create form".
  3. Choose how you want to build it:
    • AI-assisted: Describe your needs in a sentence, such as "Collect appointment requests, asking for preferred date, time slot, and the service they want." AI will prepare the questions, description, and success message. Click "Create form" after confirming the content.
    • Start from scratch: This starts with Name, Email, and Message fields, which you can then customize.
  4. Fill in the "Form name" and "Form description" (the title and description shown on your site) at the top of the "Questions" tab, adjust the fields below, and click "Create form" when finished.

"AI writing" is available next to the form name, description, success message, and field descriptions to help you polish your text. If your website has multiple languages, form content will be translated automatically; you can switch languages in the top-right corner of the form panel to proofread the translations.

Once created, you must add the form to a page for visitors to see it. If you have a headless website, see "How to add forms to a headless website" below.

Questions

Click "Add question" and select a field type:

CategoryQuestion Type
TextShort answer, Long answer
Contact InfoEmail, Phone number, Address, Tax ID, URL
SelectionMultiple choice (Single select, Multi-select, or Dropdown)
Numbers & RatingNumber, Rating
Date & TimeDate, Time
FileFile upload
LayoutDescription text

For every question, you can set the "Question", "Description", and whether it is "Required". Common details:

  • Short/Long answer: You can set a "Minimum character count" and "Maximum character count", for example, requiring at least 30 characters for a bio.

  • Multiple choice: You can "Allow multiple selections" or "Allow 'Other' input". If there are many options, change the "Presentation" to "Dropdown" to keep the form concise; dropdowns only support single selection. When multiple selection is enabled, you can set a "Minimum selections" and "Maximum selections".

  • Number: Suitable for headcount, quantity, or budget. You can set a "Minimum value", "Maximum value", and "Only accept integers". The system recognizes full-width numbers and thousands separators. Use short answer fields for phone numbers, postal codes, or IDs, not number fields.

  • URL: Visitors can enter example.com, and the system will automatically add https://.

  • Date: Use "Earliest selectable" and "Latest selectable" to limit the range. Each end has four settings:

    • Current date: e.g., setting "Latest selectable" to the current date restricts visitors to today or past dates (suitable for birthdays or purchase dates).
    • Days after current date: e.g., setting "Earliest selectable" to 1 day after the current date means visitors can only choose from tomorrow onwards (suitable for appointments).
    • Days before current date: e.g., setting "Earliest selectable" to 30 days before the current date collects dates within the last 30 days.
    • Specific date: A fixed date, such as the last day of an event.

    "Current date" is calculated based on your website's timezone.

  • Rating: You can set the "Total score" and icon (stars, hearts, thumbs up).

  • File upload: Each file is limited to 10 MB. Supported formats include images (JPG, PNG, WebP), PDF, Word, Excel, PowerPoint, and EPUB (ZIP is not supported for security). "Maximum file count" determines how many files a visitor can upload at once. Uploaded files count toward your website's Storage but are treated as private customer data—they only appear in form responses for your team to download and are not listed in the public Media Library.

  • Phone number: Visitors often omit country codes. You can select a "Default country code" so the system treats input as a number from that country; it defaults to your website's location.

  • Address: Visitors select a country or region first, and the fields adjust to local formats. For example, Taiwan uses postal code, county/city, district, and address; the US uses address, city, state, and ZIP code; Singapore uses address and postal code. Postal codes are validated against the country's format. You can set:

    • Accepted countries or regions: Leave blank to accept all; select specific ones if you only ship to certain areas.
    • Default country or region: Defaults to your website's location.
    • Ask for recipient name: Enable this if you need to ship items.
    • Save to contact's address book: When enabled, the submitted address will appear in that contact's address book. The form must include an email or phone field and a recipient name (either via "Ask for recipient name" or a field saved as a name) to enable this.
  • Tax ID: Allows users to enter a company tax ID, suitable for quotes, corporate procurement, or invoices. The system checks the format and checksum based on the selected country: Taiwan, Hong Kong, Japan, and Korea will prompt for corrections if invalid; other countries only perform basic checks. You can set:

    • Accepted countries or regions: Accepts all supported countries if left blank; if only one is selected, the user doesn't need to choose a country.
    • Default country or region: Defaults to your website's location.
    • Auto-fill company name: Choose a short answer field. If the tax ID is found in public registration data (currently supported for Taiwan), the registered name will auto-fill; users can still edit it, and the data source will be labeled below the field. If not found, it doesn't mean the tax ID is incorrect; users can still submit. The response details will show the registered name next to the tax ID.
    • Save to contact's tax info: When enabled, the submitted tax ID is saved to the contact's tax info, visible in the "Basic Info" section of their profile. Countries with searchable registration data (currently Taiwan) will automatically verify and display results. The form must include an email or phone field to enable this.
  • Description text: Not a question; visitors don't need to fill it out. Use it to add headers or body text between questions, such as sign-up instructions or section titles. It does not appear in responses or exported CSVs.

If a visitor's input doesn't meet the settings (e.g., character count too low, number out of range, too few selections), the reason will appear below the field immediately, and they must correct it before submitting.

Display conditions: Show questions based on previous answers

Some questions only apply to certain people, e.g., asking for a company name only if "Company" is selected. Expand the question, click "Add condition" under "Display conditions", and set three things:

  1. Based on: Only questions appearing before this one or hidden fields can be selected. File uploads, addresses, tax IDs, and description text cannot be used as a basis.
  2. Logic: Depends on the field type. Multiple choice uses "Selected/Not selected"; short/long answers, URLs, and hidden fields use "Equals/Does not equal/Contains"; numbers and ratings can use comparison operators; all can use "Answered/Not answered". Email, phone, date, and time only support "Answered/Not answered".
  3. Value: The option, text, or number to compare against.

Up to 5 conditions per question; if there are two or more, you can choose "Match all conditions" or "Match any condition". Questions with conditions are marked "Show based on conditions" in the list.

Notes:

  • Questions not displayed are not required (even if set to required) and their answers are not saved. If a visitor fills one out and then changes a previous answer that hides it, that question's content will not be submitted.
  • Conditions can be layered: If the base question is hidden, it is treated as unanswered.
  • Email and phone fields cannot have display conditions because they determine if the user becomes a contact.
  • When reordering questions, if you drag a base question behind a dependent one, the condition will show an error. Reorder them or remove the condition before saving.
  • If you delete a question used by other conditions, the system will list the affected questions; once confirmed, those conditions will be removed.

Who becomes a contact

Email and phone numbers are used to identify "the same person". Each form can only have one of each.

  • With email or phone field: The submitter automatically becomes a contact. Subsequent submissions by the same person accumulate under the same contact. Email fields are always required.
  • Without either: The submitter does not become a contact; only the response record is kept. The form will be marked "No contact created". Suitable for anonymous surveys or feedback.

Other fields can be saved as a contact's "Name" or as a profile item in "Save to customer profile", accumulating long-term data like company, industry, or budget for segmentation. Content relevant only to this instance (e.g., comments, appointment times) doesn't need to be saved; it stays in the response.

Form settings

Open a form and go to the "Settings" tab. From top to bottom: "Submission & Feedback", "Automation", "Contacts", "Tracking", "Submission Period & Limits", and "Response Data":

  • Submit button text, Submission success message: e.g., "Thank you for your submission, we will contact you soon.".

  • Hidden fields ("Tracking" section): To include info like campaign codes or referrers in every response, add a hidden field and enter a parameter name (e.g., campaign). If the page URL contains the same parameter (e.g., …/contact?campaign=spring), this value is saved with the response. Visitors won't see this field. Since visitors can edit URLs, do not use this for identity or permission checks.

  • Auto-record source: Every response automatically records the visitor's traffic source, including UTM parameters, referring site, and the first page visited, without extra setup. Even if a visitor lands on the homepage from an ad and navigates elsewhere before submitting, you can see which ad brought them. Sources and hidden fields appear in response details and exported CSVs.

  • Redirect URL after submission: To guide visitors to a thank-you page or next step, select "URL" and enter a site path (e.g., /thank-you) or a full https URL. It can also be another website, like a partner's booking page. Visitors see the success message first, then redirect; if left blank, they stay on the success message. If your site has multiple languages, the site path automatically adds the language prefix.

    • Redirect to messaging apps: Change the type to LINE, WhatsApp, Messenger, or Telegram and enter your account or number—no need to build links. LINE Official Accounts and WhatsApp support "Pre-filled message": the chat opens with the message already in the input box, ready for the visitor to send.
    • Insert answers: Click "Insert answers" and select a question to include the visitor's answer in the pre-filled message or URL (e.g., including their name and appointment date). You can also include the submission ID for reference. Answers can only be placed in URL paths and parameters, not the domain; remove corresponding parts from the URL before deleting a question, or it won't save.
  • Limit to one submission per person ("Contacts" section): If the same email or phone submits again, no new response is created, and the visitor sees "Only one submission allowed". The form must have an email or phone field to enable this.

  • Newsletter subscription (first item in "Submission & Feedback"): Determines if submitters can receive your future newsletters about new products, offers, or events. Three options:

    • Let visitors choose (Default for new forms, recommended): An unchecked checkbox appears before submission; only those who check it subscribe. Non-subscribers still become contacts. Suitable for inquiries, bookings, and sign-ups.
    • Subscribe on submission: No checkbox; a subscription notice appears below the submit button. Suitable for newsletters, membership sign-ups, or coupon claims where "subscription is the goal". We recommend changing the submit button text to "Subscribe" or "Claim offer" so visitors know what they are doing.
    • Do not collect: No subscription option; no one from this form will receive newsletters.

    For the first two, "Text visible to visitors" is shown. The default text includes your site name and button text, e.g., "By clicking 'Subscribe', you agree to receive the latest news and offers from [Your Site Name] via email. You can unsubscribe at any time." You can rewrite this as needed; click "Restore default" to revert. Ensure your custom text clearly states who is sending, what content will be received, and how to unsubscribe, and confirm compliance with local regulations.

    Newsletter subscription currently only covers Email; the form must have an Email field to enable this. Phone numbers in forms do not imply consent for SMS.

    Why no "pre-checked" option? In the EU, UK, Canada, and Korea, pre-checked boxes are not valid consent, and such lists have higher unsubscribe and spam report rates, which hurts your sending reputation. See Customer Lists & Subscriptions for rules and International Newsletter Regulations for country-specific requirements.

  • Automation type: Select the type closest to the form's purpose (e.g., "Inquiry", "Event sign-up") to determine which confirmation email visitors receive. See Form Confirmations for details.

Submission Period & Limits

Control when the form is active and how many responses to accept in "Submission Period & Limits":

SettingEffect
Start timeBefore the start time, the website displays "Not yet open"; visible but cannot be filled out
End timeOnce the time is reached, the website displays "Form closed"
Submission limitFill in after checking "Limit submissions"; once reached, it displays "Limit reached". Responses marked as spam are not counted. If unchecked, there is no limit
Pause submissionsWhen enabled, it immediately displays "Form closed"; disabling it restores access

Use "Pause submissions" if you temporarily don't want to accept responses, without removing the form from your site.

Response retention period

Responses are kept indefinitely by default. If you only need them for a certain period (e.g., after an event ends), select a retention period in "Response Data" at the bottom of settings: 30 days, 90 days, 180 days, 1 year, 2 years, or 3 years. This takes effect immediately without clicking "Save".

  • The period starts from the day each response is submitted. Responses exceeding the period are deleted daily, along with uploaded files, and cannot be recovered.
  • When selecting a period, if any responses already exceed it, the system will notify you of the count. If you need to keep them, export to CSV first.
  • Only response content is deleted. The submitter's contact profile, customer profile, and newsletter subscription status are kept. The contact's activity log will show they filled out the form, but the answer summary will change to "Response deleted".
  • This setting is not available for forms currently being created; it appears after the form is created.

Add the form to your website

  1. Go to Edit Website and open the page where you want the form.
  2. Add the "Online Form" module.
  3. Select the form you just created under "Select form".
  4. Under "Layout & Appearance", choose the "Text layout" (text above, left, or right) and adjust "Items per row" if needed.
  5. Publish your website.

Form questions, descriptions, and success messages are managed in the Marketing section; in the website editor, you only choose which form to display and how to style it. You don't need to re-select the form after editing questions; the form on the site updates automatically.

Forms can also be placed in pop-ups that appear when visitors arrive, suitable for newsletter sign-ups or coupon claims: go to "Marketing › Site Widgets › Pop-ups" and set the pop-up "Content" to "Form". See Site Widgets for "Adding a form to a pop-up".

View responses

Click the response count in the "Online Forms" list or "More actions" → "View responses" to open the response page. The top shows performance for the last 90 days:

  • Views: How many times the form was seen.
  • Started: How many times someone started filling it out.
  • Responses: How many were submitted.
  • Completion rate: The percentage of those who started and finished.

After enough data is collected, a "Where visitors dropped off" chart appears: the last question visitors were on before leaving (last 90 days). If a specific question has a high drop-off rate, it may be too difficult, asked too early, or unclear. Try making it optional, moving it later, or adjusting the description. This chart only tracks counts, not unsubmitted content.

Below is the list of responses. Use the search bar to find responses (by name, email, or answer) and filter by status and period (today, last 7/30/90 days):

StatusMeaning
UnreadNewly received, not yet opened
ReadAlready viewed
SpamFlagged by the system or marked as spam by you
ArchivedResponses archived via AI assistant or API
  • Click a response to open it in the right panel (full screen on mobile); opening it marks it as read.
  • Select multiple responses to "Mark as read", "Mark as spam", or "Delete".
  • Click "Mark all as read" to clear unread items.
  • If there are attachments, click the download button next to the filename; if removed, it shows "Attachment removed".
  • Click "View contact" to open the submitter's contact profile.
  • Click "Export CSV" to download responses: this exports the latest 10,000 responses for this form (ignoring current search/filters; spam is included and can be distinguished by the status column). Uploaded files are not exported. Responses contain personal data, so you need the "Export form responses" permission (Owners and Admins have this by default; custom roles do not).

Spam responses

Content clearly submitted by bots is blocked; promotional or suspicious content is automatically marked as "Spam". It won't create a contact or notify you. See Form & Checkout Protection for how this is determined.

  • If a normal response is promotional, click "Mark as spam". It is no longer counted in completion rates or limits, and the contact is not deleted.
  • If a real person is misidentified, find the response in "Spam" and click "Unmark as spam".
  • Responses marked as spam are automatically deleted after 30 days if not unmarked.

Delete responses or forms

  • Delete a response: The content is gone and cannot be recovered. If the submitter is a contact, the contact remains, but the answer summary in their activity log changes to "Response deleted". Use "Response retention period" to have responses deleted automatically.
  • Delete a form: Click "More actions" → "Delete" next to the form in the list. The form and its responses move to the trash and stop accepting submissions. It can be recovered within 30 days; after that, it is permanently deleted.
    • Recover or permanently delete: Go to "More actions" → "Trash" in the top-right of the list, then click "More actions" next to the form to "Recover" or "Permanently delete". Recovered forms return to the list with their previous status and responses. Permanent deletion removes all responses and attachments; forms with responses require entering the form name to confirm. Contacts, customer profiles, and newsletter consent are kept.
    • Forms with responses must be paused first: Active forms only show "Pause submissions"; you must pause them before "Delete" appears.
    • Forms on pages or pop-ups cannot be deleted: The system will list where the form is used. For pages, remove the "Online Form" module in the website editor and publish; for pop-ups, go to "Marketing › Site Widgets › Pop-ups" and change the content back to "Text & Button" or delete the pop-up. To stop submissions, just use "Pause submissions", and the site will show "Form closed".

"Duplicate" in the same menu creates a new form with the same content (questions, settings, automation type, and retention period are copied; responses are not), suitable for recurring events.

How to add forms to a headless website

Headless websites don't have the "Edit Website" feature; forms are displayed by your frontend:

  1. Create the form in Marketing › Online Forms as described above. Questions, submission periods, limits, and response viewing work the same.
  2. Go to the "Frontend" page in your dashboard to see how to display the form on your frontend, and hand this to your engineer or AI coding tool.
  3. The frontend can use Kanorio Elements form components or use the API to build custom form interfaces. See Forms in the developer documentation.

When visitors submit a form from your domain, that domain must be listed in the allowed origins under "Website Settings › Developer". When using form components, you don't need to re-deploy after changing questions in the dashboard; the form on the frontend updates automatically. Pop-ups are managed by Kanorio and are not available for headless websites.

FAQ

The form must be added to a page. Go to the website editor, add the "Online Form" module, select the form, and publish. For headless websites, the form must be displayed by your frontend; see "How to add forms to a headless website" above.

Go to the form's "Settings" and check if the "Closing date" has passed or if "Pause submissions" is on. If it says "Limit reached", increase the "Submission limit".

Pro plans and above send confirmation emails based on the "Automation type" and require domain verification. See Form Confirmations for details.

The form lacks an email or phone field, or the response was marked as spam. Unmarking it as spam will create the contact.