Skip to content
Contlo by QuestionPro
Browse documentation

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.

Forms → EditDrag-and-drop blocksAutosaves to a draftWeb and mobile view

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.

AreaWhat it is for
Top barThe 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 panelFour 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.
CanvasThe form as visitors see it. Click anything on it to select it.
Right panelThe options for whatever is selected on the canvas. It reads "Nothing selected" until you click a block.
Step barAlong 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.

  1. Click a step in the step bar to show it on the canvas.
  2. 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.
  3. 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

  1. Open the Design tab.
  2. Drag a block onto the canvas and drop it where you want it in the current step.
  3. Click the block on the canvas to open its options in the right panel.
  4. 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?".
BlockWhat it addsAvailability
TextA heading or paragraph with rich formatting.All forms
ImageA picture inside the step.All forms
Email InputAn email address field.All forms
Phone InputA phone number field with country code, plus SMS and WhatsApp consent.All forms
ButtonA button that submits, closes, moves on or opens a URL.All forms
Text InputA free text or number field saved to a contact property.All forms
Date InputA date field, for a birthday for example.Web forms
TimerA countdown that adds urgency to an offer.Web forms
DropdownA pick-one menu saved to a contact property.Web forms
Single SelectPick-one options shown side by side or stacked.Web forms
Product BlockProducts from your catalog inside the form.Shopify and WooCommerce
Discount CodeA 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.

SettingOptionsEffect
SMS ConsentCollect SMS consentContlo texts your SMS consent message to the number after signup. Set that message up in SMS settings.
SMS ConsentDo not Collect SMS consentThe contact is marked as subscribed to SMS as soon as they submit. This option appears only on accounts where it is allowed.
Whatsapp ConsentCollect Whatsapp consentShows 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.

BlockOptions
Text InputLabel, 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 InputLabel, Placeholder Text, Date Format (DD/MM/YYYY, MM/DD/YYYY, DD-MM-YYYY or MM-DD-YYYY), Profile Property (date properties only) and Required.
DropdownLabel, 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 SelectThe 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.

Buttons and what they do

Select a button and set its Action.

ActionWhat happens when a visitor clicks
Submit FormSaves the fields on the step and moves to the next step.
Close FormCloses the form without saving anything.
Redirect To URLOpens the Button URL. Tick Submit Form on Redirect to save the fields first, and Open in New Tab to keep your store open. Contlo adds https:// if you leave it out.
Go To Next StepMoves to the next step without submitting.
Spin WheelSpin wheel forms only: spins the wheel.

The rest of the panel styles the button: Button Text, font, Label Color, Background Color, Corner Radius, Button Height, Button Width (Stretch Width or Fit to Text Width, with Button Alignment when fitted), padding and Button Border.

The X in the corner of the form is its own item. Click it to set Size, X Color, X Thickness, Background Color, Border Color and its margin.

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.

ImageWhere to set it
Image blockDrag an Image block into a step, then click Add Media in the right panel.
Side imageOn 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 imageStyle → Form Background → Background Image, with an Image Overlay Color to keep text readable.
Teaser imageIn 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.

SettingWhat it does
Discount Coupon TypeStatic 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 cartApplies 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 TextBorder, 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 feedShowsNeeds this display trigger
RecommendedRecommended products.Any
Abandoned CartThe 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 ProductThe product the visitor was looking at.X seconds after viewing product
Custom ProductOne 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.

MessageWhat 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.

SectionSettings
Form TypePopup, Flyout or Embedded. Not shown for spin wheels.
Flyout PositionFlyouts only. Pick one of eight positions around the screen and set Form Margin (in pixels) for Top/Bottom and Left/Right.
Form SizeWidth: Small, Medium, Large or Custom (then enter Custom Width). Embedded forms also have Full Width. Min Height in pixels.
Form LayoutNo Image, Left Image or Right Image, with Layout Image Size (Small, Medium or Large) when there is an image.
Form StylesCorner Radius, Border Width, Border Style, Border Color, Padding (in pixels), and for popups and flyouts Shadow Color, Shadow Blur and Shadow Spread.
Form BackgroundBackground Color, Background Image, Image Overlay Color and Overlay Color.
Input Field Text StylesColor, font family, size and weight of what visitors type. Switch on Preview Text to see sample text in the fields.
Input Field Label StylesColor, font family, size and weight of field labels.
Placeholder & Error StylesPlaceholder 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 StylesBorder 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.

ButtonWhen you see itWhat it does
PublishThe form is not live yet.Makes the draft the live version, turns the form on and returns you to the Forms page.
Publish ChangesThe form is live and has unpublished edits.Replaces the live version with your draft.
PublishedThe form is live and has no unpublished edits.Nothing to publish.
Proceed to A/B SettingsThe form has an A/B test.Opens the test settings, where you publish the test. See A/B test a form.
Discard DraftIn the three-dot menu.Throws away every unpublished edit and restores the last published version.
Exit EditorAlways.Leaves the builder. Your draft is kept for next time.

Troubleshooting

ProblemWhat to do
"Please select the correct targeting condition!" when publishingThe 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 CodeProduct Block needs a Shopify or WooCommerce store. Discount Code needs a Shopify store.
A step has no Delete optionThe form is at its minimum number of steps, or it is the fixed final step.
My changes are not on the storeClick 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.

Related guides

Can't find something? Email us