Form builder
The form builder is where you design what a visitor sees: the signup step, the success step, and an optional teaser. You drag blocks onto a canvas, set each block's options on the right, and style the whole form on the left. Changes save to a draft as you work, and nothing reaches your store until you publish.
Les guides sont en anglais.
Find your way around
Open the builder by creating a form, or by clicking Edit on a row of the Forms page. Use a desktop browser.
| Area | What it is for |
|---|---|
| Top bar | The form name, the Create A/B Test link, the Web View and Mobile View toggle, the save status (Saving… or Saved), Exit Editor, the Publish button and a three-dot menu with Preview Form (Beta) and Discard Draft. |
| Left panel | Four tabs. Design holds the blocks you can add. Style sets the form's type, size, layout and look. Targeting and Behavior decide who sees the form and when: see Form targeting and behavior. |
| Canvas | The form as visitors see it. Click anything on it to select it. |
| Right panel | The options for whatever is selected on the canvas. It reads "Nothing selected" until you click a block. |
| Step bar | Along the bottom: the steps of the form in order, Add Step, and Teaser when the teaser is on. |
Steps: signup, success and teaser
A form is a sequence of steps. A visitor sees one step at a time and moves forward when they click a button. A form built from scratch has Email Opt In followed by Success. A spin wheel has Wheel, Success Message and Losing Message.
- Click a step in the step bar to show it on the canvas.
- Click Add Step, choose Email Opt-In, SMS Opt-In or Blank Step, then click Add Step. The new step is placed before the final step.
- Click the arrow next to a step for Edit Name, Clone Step and Delete.
- The final step (the last two on a spin wheel) is fixed: it has no menu, so it can't be renamed, cloned or deleted from the step bar.
- Delete is offered only while the form has more than two steps (three on a spin wheel).
- A cloned step is added right after the original with "copy" added to its name.
- A common setup is email first, then phone: add an SMS Opt-In step after the email step so visitors who share an email can also subscribe to SMS.
The teaser
The teaser is a small tab or bubble that stays on the page and opens the form when clicked. Turn it on under Behavior → Teaser → Enable Teaser, then click Teaser in the step bar to design it. Its options are listed in Form targeting and behavior.
Add, move and remove blocks
- Open the Design tab.
- Drag a block onto the canvas and drop it where you want it in the current step.
- Click the block on the canvas to open its options in the right panel.
- Use the block's Clone element and Delete element controls on the canvas to duplicate or remove it. Deleting asks "Are you sure you want to delete this element?".
| Block | What it adds | Availability |
|---|---|---|
| Text | A heading or paragraph with rich formatting. | All forms |
| Image | A picture inside the step. | All forms |
| Email Input | An email address field. | All forms |
| Phone Input | A phone number field with country code, plus SMS and WhatsApp consent. | All forms |
| Button | A button that submits, closes, moves on or opens a URL. | All forms |
| Text Input | A free text or number field saved to a contact property. | All forms |
| Date Input | A date field, for a birthday for example. | Web forms |
| Timer | A countdown that adds urgency to an offer. | Web forms |
| Dropdown | A pick-one menu saved to a contact property. | Web forms |
| Single Select | Pick-one options shown side by side or stacked. | Web forms |
| Product Block | Products from your catalog inside the form. | Shopify and WooCommerce |
| Discount Code | A coupon code the visitor can copy or apply. | Shopify |
Most blocks end with a Show On setting: All Devices, Desktop or Mobile. Use it to hide a large image on phones, for example. Most blocks also have Padding (in pixels) and a Padding Background Color.
Email and phone fields, and consent
Email Input
Tick Label to show a label and type the Label Text, set the Placeholder Text, and tick Required to block submission without it. A visitor who submits an email address is subscribed to email.
Phone Input
The phone field has the same label, placeholder and Required options, plus Default Country, which sets the country code shown first. Below them are the consent settings.
| Setting | Options | Effect |
|---|---|---|
| SMS Consent | Collect SMS consent | Contlo texts your SMS consent message to the number after signup. Set that message up in SMS settings. |
| SMS Consent | Do not Collect SMS consent | The contact is marked as subscribed to SMS as soon as they submit. This option appears only on accounts where it is allowed. |
| Whatsapp Consent | Collect Whatsapp consent | Shows a WhatsApp consent line under the field. Style it with Consent Font Family, Consent Font Size, Consent Font Weight and Consent Text Color. When a visitor accepts, Contlo starts their WhatsApp opt-in. |
Text, date and choice fields
These fields collect extra details, such as a first name, a birthday or a product interest, that you can later use in segments and personalized messages. Each one saves its answer to a contact property.
| Block | Options |
|---|---|
| Text Input | Label, Placeholder Text, Input Type (Text or Number), Profile Property and Required. The property list shows text properties for a text field and number properties for a number field. |
| Date Input | Label, Placeholder Text, Date Format (DD/MM/YYYY, MM/DD/YYYY, DD-MM-YYYY or MM-DD-YYYY), Profile Property (date properties only) and Required. |
| Dropdown | Label, Profile Property, and Options. Click Add Option for each choice and give it a Label (what the visitor sees) and a Value (what is saved to the contact). |
| Single Select | The same as a dropdown, plus Options Layout: Horizontal or Vertical. |
If the property you need does not exist, click Create New Property under the Profile Property menu, enter a Property Name, choose a Datatype and click Create Property. If you link a choice field to a true or false property, its option values are set to True and False for you. Manage properties in Custom properties and tags.
Text and images
A Text block opens an editor with font and size menus, bold, italic, underline, strikethrough, superscript and subscript, bullet and numbered lists, alignment and links. Edits to text save a moment after you stop typing.
A form can carry images in four places.
| Image | Where to set it |
|---|---|
| Image block | Drag an Image block into a step, then click Add Media in the right panel. |
| Side image | On the Style tab choose Left Image or Right Image under Form Layout, then click the image area on the canvas. Each step has its own side image, with Image Position (Cover or Contain) and horizontal and vertical alignment. |
| Background image | Style → Form Background → Background Image, with an Image Overlay Color to keep text readable. |
| Teaser image | In the teaser's Background Properties. |
Add Media opens the media picker, where you can upload a file or describe a picture and have AI create it. Once an image is set, use Replace Image or the remove icon.
Coupon reveal, timers and products
Discount Code
Put a Discount Code block on the success step so the coupon is revealed only after the visitor signs up. This block is available on Shopify stores.
| Setting | What it does |
|---|---|
| Discount Coupon Type | Static Coupon shows the same code to everyone: type it under Enter Coupon Code. Unique Coupon gives each visitor their own code: choose a Discount Type (Fixed Amount or Percentage) and a Discount Value. A percentage can't exceed 100. |
| Automatically apply code to cart | Applies the code in the shopper's cart when the step shows. Shown only if it is enabled for your account. |
| Show 'Apply Code' | Adds an apply link to the block. If the block sits on the first step, the code is applied but not copied to the clipboard. |
| Block Styles and Discount Code Text | Border, background, and the code's font and color. |
For how coupon codes work across Contlo, see Coupons.
Timer
Set Timer Type to Customer Session to count down a length of time you enter in Hrs, Mins and Secs, or to Fixed End Time to count down to one Date Time for everyone. You can also style the timer digits and time labels.
Product Block
Choose a Product Feed, then a Product Layout (Horizontal or Vertical) and, where offered, the Number of Products. Switches turn the price, description and button on or off, and the pencil next to each opens its styling.
| Product feed | Shows | Needs this display trigger |
|---|---|---|
| Recommended | Recommended products. | Any |
| Abandoned Cart | The products left in the visitor's cart. Product Linked To sends clicks to the Product Page or Cart Page. | X seconds after cart abandonment |
| Viewed Product | The product the visitor was looking at. | X seconds after viewing product |
| Custom Product | One product you pick under Product. | Any |
Spin wheel settings
On a spin wheel form, click the wheel on the canvas to open its options.
- Wheel Layout: Half or Full. On the Style tab, Form Layout places it as Left Wheel or Right Wheel.
- Configure Settings: opens Configure Tiles. Set the Number of sections (3 to 10). For each tile choose Win/Lose, a Label, a Section Colour, a Coupon Type (Static, Unique - Fixed Amount, Unique - Percentage or Free Shipping), the Coupon Value and a Probability(%). Click Save Changes.
- Preview Spin Wheel: spins the wheel on the canvas.
- Wheel Styles and Label Styles: Edge & Center color, Pin Colour, shadow, and the label font.
Give the button on the wheel step the Spin Wheel action. Winners continue to Success Message and everyone else to Losing Message.
| Message | What to fix |
|---|---|
| "Sum of all the Probability(%) should be 100%" | Adjust the tile probabilities so they add up to exactly 100. |
| "At least one tile should be a winning tile" | Mark at least one tile as a win. |
| "Please enter all required details" | Every tile needs a label, color and probability, and every winning tile needs a coupon unless it is Free Shipping. |
Style the whole form
The Style tab controls the form as a whole.
| Section | Settings |
|---|---|
| Form Type | Popup, Flyout or Embedded. Not shown for spin wheels. |
| Flyout Position | Flyouts only. Pick one of eight positions around the screen and set Form Margin (in pixels) for Top/Bottom and Left/Right. |
| Form Size | Width: Small, Medium, Large or Custom (then enter Custom Width). Embedded forms also have Full Width. Min Height in pixels. |
| Form Layout | No Image, Left Image or Right Image, with Layout Image Size (Small, Medium or Large) when there is an image. |
| Form Styles | Corner Radius, Border Width, Border Style, Border Color, Padding (in pixels), and for popups and flyouts Shadow Color, Shadow Blur and Shadow Spread. |
| Form Background | Background Color, Background Image, Image Overlay Color and Overlay Color. |
| Input Field Text Styles | Color, font family, size and weight of what visitors type. Switch on Preview Text to see sample text in the fields. |
| Input Field Label Styles | Color, font family, size and weight of field labels. |
| Placeholder & Error Styles | Placeholder Color, Error Message Text Color, Letter Spacing and the Required Fields Error Message. Switch on Preview Required Text to see the error on the canvas. |
| Input Field Styles | Border Width, Border Style, Border Color, Corner Radius and Field Height for all fields. |
Preview on desktop and mobile
- Use the toggle in the top bar to switch between Web View and Mobile View. Mobile view shows the form inside a phone frame.
- Check both views for every step. Blocks set to Show On → Desktop disappear in mobile view, and the other way around.
- For a live check, open the three-dot menu and click Preview Form (Beta). The step you are on opens in a new browser tab.
Save, publish and discard
You never need to save by hand. Each change is saved to a draft, and the top bar shows Saving… then Saved.
| Button | When you see it | What it does |
|---|---|---|
| Publish | The form is not live yet. | Makes the draft the live version, turns the form on and returns you to the Forms page. |
| Publish Changes | The form is live and has unpublished edits. | Replaces the live version with your draft. |
| Published | The form is live and has no unpublished edits. | Nothing to publish. |
| Proceed to A/B Settings | The form has an A/B test. | Opens the test settings, where you publish the test. See A/B test a form. |
| Discard Draft | In the three-dot menu. | Throws away every unpublished edit and restores the last published version. |
| Exit Editor | Always. | Leaves the builder. Your draft is kept for next time. |
Troubleshooting
| Problem | What to do |
|---|---|
| "Please select the correct targeting condition!" when publishing | The form has a product block whose feed doesn't match the display trigger. An Abandoned Cart feed needs X seconds after cart abandonment and a Viewed Product feed needs X seconds after viewing product. Change the trigger on the Targeting tab or change the feed. |
| The right panel says "Nothing selected" | Click a block on the canvas, or drag one in from the Design tab. |
| I don't see Product Block or Discount Code | Product Block needs a Shopify or WooCommerce store. Discount Code needs a Shopify store. |
| A step has no Delete option | The form is at its minimum number of steps, or it is the fixed final step. |
| My changes are not on the store | Click Publish Changes. Edits stay in the draft until you do. |
Forms for your mobile app open in a simpler builder with a single screen and a shorter list of blocks.
Guides associés
- Forms overviewTurn store visitors into subscribers with popups, flyouts, embedded forms and spin wheels. Create, publish, measure and A/B test them.
- Form targeting and behaviorChoose which pages and visitors see a form, what triggers it, how often it returns, how it closes, and how the rules combine.
- CouponsCreate static or unique Shopify discount codes in Contlo and add them to SMS, WhatsApp and automation messages.
- Custom properties and tagsAdd your own contact properties to store details Contlo doesn't track by default, and manage the tags you use to organize campaigns.
- SMS setup and settingsConnect an SMS vendor, get a sending number or register your headers, sync templates, whitelist tracked links on DLT and edit consent replies.