What this article covers
Why the Jicoo external-form wizard sometimes cannot auto-detect fields from a given URL
Step-by-step instructions for adding fields manually
Provider-specific tips (HubSpot, Typeform, Tally, Fillout, Paperform) for finding the correct field keys
Why auto-detection can fail
The external-form wizard reads the HTML of the URL you paste and tries to reflect its form fields into your Jicoo definition. The following situations prevent automatic detection:
The form is rendered inside a cross-origin iframe.
Providers such as HubSpot (hbspt.forms.create), Typeform, and Tally embed their form inside an iframe served from their own domain. Browser security prevents Jicoo from reading the field definitions inside that iframe.The URL is not publicly accessible.
Login-gated pages, preview-only URLs, and IP-restricted pages cannot be analyzed. Please use a public URL.The form renders too slowly.
If the page takes longer than the 10-second analysis timeout to draw its form, Jicoo cannot read it in time.
In all of these cases, you can still wire up Jicoo routing (booking popup / redirect / thank-you page) by entering the fields manually with the steps below.
How to add fields manually
1. Click "Add field"
Find the Add field button below the field-definitions section. Each click adds a new empty field card.
2. Enter a label
Type the question text shown on the form (e.g. "Email", "Company"). The label is only used for your reference inside Jicoo and does not need to exactly match the source form.
3. Pick a field type
Choose the type that matches how the source form behaves:
Text
Multiline text
Email
Name
Phone number
Address
Single choice (radio)
Multiple choice (checkboxes)
Dropdown
4. Configure the source mapping
This tells Jicoo how to identify the matching field in the submitted form payload.
Source key type: the HTML attribute used to identify the source form's
<input>. Most forms usename. Some useid; check the HTML of the source form to confirm.Value: the actual value of that attribute. For example, if the source form has
<input name="email">, enteremail.
5. For choice fields, list the options
If you picked Single choice / Multiple choice / Dropdown, add one option per line. You can also map each option's internal value (value string) to its label.
Provider-specific tips
HubSpot forms
Use the field's
nameattribute — typicallyfirstname,lastname,email,company,phone,message, etc.You can find each field's internal name in the HubSpot form editor under the Fields tab.
Select
nameas the source key type.
Typeform
Field
namevalues are often unique hashes. Open the live form page and inspect each<input name="...">with your browser's developer tools.
Tally / Fillout / Paperform
Field names usually follow the
name="question_xxx"pattern. Inspect the live form page to get the exact key.
Test the setup
After saving the fields, copy the embed snippet generated in the next step and paste it into the <head> of the page hosting your form. Submit a test entry and verify that the configured Jicoo routing (booking popup, redirect, or thank-you page) fires as expected.
If detection still fails or routing does not behave as expected, please contact Jicoo support.