To create a new form:
Category: You can organize your forms based on their goals, campaigns, etc. For more information, see Global Categories.
Publish options: The Yes/No toggle is the fastest way to publish or unpublish a form. Unpublished forms won’t be visible on pages you’ve added the form to using JavaScript. If you used the manual copy and pasted the HTML code onto your page, the form will still be visible but not submittable. Contacts will see an error message if they try to submit the form.
Disable search indexing: Select Yes to prevent search engines from finding and displaying the form in search results for related topics.
Kiosk Mode: Select Yes to turn off tracking, and prevent Campaign Studio from generating new cookies or attaching the IP address to the contact record. This may also be referred to as data entry mode. Use this for instances where several contacts may enter their information using the same device, such as a conference. Kiosk mode prevents the activity on the device from being tied to one contact.
Render Style: When you select Yes, the form displays on your page or application with the styling from either the selected theme the Attributes tab of a field editor. When set to No, the form adopts the CSS of your page or application.
Theme: The selected theme dictates the styling of your form when it’s added to an external page or application, if Render Style is set to Yes.
Note
Not all themes include form styling. Check the Features column on your Themes page (in Settings) to see which available themes include CSS for forms.
Choosing the proper field type helps Campaign Studio users gather data appropriately on forms, and can optimize the end-user’s experience of completing the form. On some devices, certain form fields may display differently and the wrong field type may result in a more difficult submission, resulting in lost conversions.
To add a new field:
CAPTCHA: A basic form of spam protection, requiring a human to submit an answer or identifying when spambots try to submit data in a hidden CAPTCHA field (honeypot). Acquia recommends using some form of CAPTCHA on every form. Campaign Studio also supports reCAPTCHA v2, which you’ll see as a field type after setting up the reCAPTCHA plugin.
Checkbox Group: Enables a contact to select one or more options from a list, using check boxes. Campaign Studio subscribers also use the Checkbox Group for a single option on opt-in forms to gain consent to use cookies and send marketing emails or other messages to the contact.
Note
Checkbox Group works with Boolean and Select - Multiple field types but not Select fields.
Date: Validates date fields in your default date format, and improves the end-user experience when completing the form. In a web browser on a laptop or desktop, the field shows selectors for month, day, and year. On mobile devices, a calendar displays.
Date/time: Like the date field, but a selector will displays for time.
Description area: A basic header field, most commonly used to give the form a visible title on the page. The Header field acts as the field name or label. The description area (in the Properties tab) is a free text editor where you can add a description of the form. You can also do this by adding text around the form on your page, but if you’re using the same form in several places adding the description on the form enables an efficient single change.
Email: Requires a field containing an email address with the proper
syntax - name@domain.com. Acquia recommends having a required Email
field on your forms, as email addresses are the default unique identifier.
File: Enables contacts to upload files with the form.
Hidden: A field doesn’t display with the form. Users may add default values to save with the form for reporting or internal tagging purposes.
HTML area: Enables marketers to add custom code into their forms.
List - Country: Populates Campaign Studio’s default, non-editable country list. To use a custom list, use a Select field type and manually enter the countries you’d like to display in the list.
Number: Validates that the entered values are digits. This field allows decimals and negatives, but no other non-numerical values (including commas). On mobile devices, the keyboard changes to a number pad when a contact selects this field to complete.
Page break: Enables marketers to break up the form into multiple pages or field groupings.
Password: Enables contacts to create a password. Use the field if the form is used to create an account and the results post to another form/system. The entered field value shouldn’t save, because the field saves in plain text on the contact record.
Phone: Like the number field, but maps to the Phone field and validates numbers using international format. The validation requires a dialing code (for example, +1 for the United States or +44 for the United Kingdom).
Radio Group: Gives contacts a a single-select list of options, with a radio button. This may also be called an option button group.
Select: Displays a menu where a contact may choose one option. This field also allows multiple selections, which changes the display to a box with the options listed. On mobile devices, a single selection displays as a dialog box with radio buttons, while a multi-select menu displays in a dialog box with check boxes.
Social Login: Connects a contact’s Twitter, Facebook, or LinkedIn profiles with the Campaign Studio contact record.
Text: A free-form text box with a limit of 255 characters. Common fields such as first name, last name, position/job title, city, etc. are often built as text fields.
Textarea: A longer-form text field with a character limit of 65,535 characters.
URL: Validates the entry must be a URL, including https:// or
http://.
Based on the selected field type, Campaign Studio displays various tabs in the fields editor. The available tabs are:
Label: The title of your field - telling the contact what you’d like them to enter in the field. The label displays before the form field by default.
Show label?: When set to No, the label doesn’t display on the form.
Save result?: When set to No, Campaign Studio doesn’t save the data entered in the list of form submission results. If you map the field to a contact field, Campaign Studio still saves the data to the contact record.
Default value: In case the contact doesn’t submit data for the field, you may enter a default value to submit with the form. This is useful for hidden fields and reporting.
Help message: To add more detail on what you’d like a contact to enter, add a custom help message.
Input placeholder: Adds text within the form field, acting as a label or help message. When used as a basic text field, (styling is from a “Fresh” landing page theme), the options display like this:
The Mapped Field maps the form field to where you want the data to save on a contact or company record. Without a field mapped here, the data won’t save to the contact or company record. The data type you choose for the form field should match the data type for the Campaign Studio field. For example, a Date and time form field should map to a Date and time standard or custom field. Checkbox group form fields work well with Select - Multiple Campaign Studio fields. Radio Group or Select form fields work well with Boolean, Select, or Select - Multiple Campaign Studio fields.
*) to indicate they’re
required.This is required. Enter your custom message in the box to change the
display.The Properties tab doesn’t display on all field types. Different field types have different properties options.
What is 2+2? or
Enter "CAPTCHA", enter the expected response in the CAPTCHA answer
box. In these cases, 4 or CAPTCHA would be the answers. The field’s
Label should be your question, or you may label the field CAPTCHA and
use the input placeholder, depending on your preference for the form’s
appearance.The answer to "{label}" is incorrect. Please try again. You may enter
custom message here instead.
Here, you enter the options a contact will select from.
Yes, I accept that I may receive email communications from
this company.. Your Value could be a Yes or 1 as a positive
boolean value.
Use the Description Area field when there’s any information you’d like to display with the form. Often, users will add this kind of information on the webpage, landing page, or application instead of the form, but it’s an option in the form builder.
Empty Value: This serves the same purpose as an Input Placeholder, which is available on most other field types. The Empty Value is not a default value, and Campaign Studio won’t save the value to the contact record.
Allow Multiple: This option transforms the field from its default Select field type into a Select - Multiple field type.
Note
Campaign Studio’s Country field is a predefined, non-editable list. To edit the list’s options, create a Select field and manually enter the options for your custom country list.
Attributes are CSS tags to change the styling of a particular form. If you set Render Style to No on the form, these attributes will be ignored.
style="attribute: descriptor" to change the style. For example, to change
the label to red, use style="color: red" or style="color: #ff0000".
The Behavior tab helps marketers improve the experience for the contact completing the form. It also helps marketers implement progressive profiling, to gather more data from the contact which helps in optimized personalization.
1 and 200. This field will hide the field until the contact
submits the same form the stated number of times. When left undefined, the
field will display every time the contact sees the form. The goal is to
shorten the form. Use it with hiding fields when values exist.To change the order of the fields on your form:
You may want to have things happen after a contact submits a form. These may
include communications with your contact, tracking, internal notification, or
other lead management. The same the form actions available on Campaign forms
are available on standalone forms. The actions available on both display
with an asterisk *.
Add to company’s score: If the contact who submitted the form is associated with a Company record in Campaign Studio, you may add points to the Company’s overall score. Company scoring in Campaign Studio doesn’t aggregate points for all its associated contacts. Any actions you’d like to contribute to a company’s score must be explicitly set. Negative numbers are valid if you’d like to subtract from a company’s score based on a contact submitting the form. If the contact hasn’t been tracked and the form doesn’t include a field mapped to Company or Company Name (on the Company object), no points award to a Company.
Adjust contact’s points: More in depth than the company score action, this action allows you to multiply or divide a contact’s score. Select the operator and the amount you’d like to change the points by (for example: add 10, subtract 5, multiply by 3, divide by 2). If the form is collecting information which doesn’t identify the contact, Campaign Studio saves the points to the anonymous contact record. If that anonymous contact record converts to or merges with a known contact record based on some identifying event (form submission with the unique identifier or link click in a message), the points will stay with the contact.
Modify contact’s segments: This action enables users to change a contact’s segment membership when they submit a form. Type in the name of the segment you’d like to add a contact to or remove a contact from. You may use both fields in one Action, and may include multiple segments in either or both fields. Dynamic segments based on filters update based on information on the contact record. That includes the data from the form submission, as long as the fields map to Contact or Company fields. Typically, you’ll want to use static segments here. An example of a time when you could remove someone from a dynamic segment is for an event registration. You may build a filter-based segment for your invitation campaign, but once a contact submits the registration form you want to remove them from the source segment so they’re removed from the invitation campaign.
Modify contact’s tags: If you use tags for tracking, segmentation, and reporting, you may add or remove tags based on a form submission. If you’d like to add or remove a tag you’ve used before, select the tag from the list which displays when you click in the field. To find a tag, type the name to search and shorten the list. To adding a new tag, type the full tag name and press Enter on your keyboard to save the tag.
Record UTM Tags: If the page your form is on has UTM tags, whether it’s a Campaign Studio landing page or not, Campaign Studio can record those UTM tags to the contact record. This is useful for reporting on where your new leads and form submissions are coming from.
Remove contact from do not contact list: If a contact has unsubscribed and this form gives you permission to send them emails again, use this action to remove the Do Not Contact designation.
Download an asset: Using this option triggers an asset download when the contact clicks the Submit button. If you use categories to organize your assets and want the contact to receive the most recent published asset from a certain category, choose that option, and then choose the category to download from. Or, choose a specific asset to downloaded. For more information on assets, see Assets.
Post results to another form: Use this option to connect your Campaign Studio form with some other form. You may have forms in other tools which you use for tracking and reporting. Or, you may have back end forms triggering software instance creation. Enter the URL where the form should post to, and email address(es) for anyone who should receive error notifications. If the form you’re posting to is behind a firewall, also enter the authorization header. If the field aliases (machine names) for any of the fields don’t match, enter the alias the other form uses for any fields on the Campaign Studio form.
Push contact to integration: Once a contact as submitted the form, you may want to push them to another piece of software you’re using for contact management (such as a CRM). Be sure the plugin you want to push contacts is configured and published, then select it here. The Salesforce plugin enables users to select a campaign and a campaign status, beyond a basic push to Salesforce.
Send email to contact: To directly email the contact after they’ve submitted a form, use this option. Select Template email from the list, or click +New Email to build a new one. After you’ve selected an email, you can also pop open a new window to make edits or to preview the email.
Send email to user: Select this option to email an internal user after a contact submits a form. This is limited to people who have been set up as Campaign Studio users. Similar to the Send email to contact option, select the Template email you’d like to use or create a new one. Any tokens in the email will display the data from the contact, not the user.
Send form results: This is most commonly used to send an internal
notification when a contact has submitted a form. You may also use it to send
a confirmation of the submission to the contact, with the data the contact
entered. Make the subject line clear which form the submission is for,
particularly if you have several forms with the results going to the same
person or people. The Reply to contact option sets the reply-to
address on a notification email to the contact’s address, so if you click
reply on the email your recipient will be the contact. If you have contact
owners assigned in Campaign Studio, you can send the notification directly to
the submitter’s owner. You may also decide to send the email directly to the
contact. You may style the message section as you’d like. The tokens for the
fields will populate for any fields which exist when you add this action. If
you later make changes to the fields, come back to this action and re-enter
the field tokens. To do that, click in the Message box where to place your
cursor. Click the field name on the right side and Campaign Studio inserts
the token where your cursor is. If you’d like to use a Template email instead
of the basic form results template, select one from the
Import from an existing template box. Finally, add the addresses for the
people you’d like to receive the form results. Unlike the
Send email to user action, Send form results emails aren’t limited to
Campaign Studio users. You may send these to internal employees who aren’t
users, 3rd parties, or to distribution lists.
You can add form code to your application or webpage in several different ways.
If you’re adding a form to a Campaign Studio landing page or a Drupal, Joomla!, or Wordpress page, you can use a shortcode. In each case, replace``ID#`` with the form’s ID number. You can find the ID in the forms list in the far right column, or if you’re on the form, it’s the number at the end of the URL. These options use JavaScript, and will keep the form up to date as you make changes.
Campaign Studio Landing Page: {form= ID#}
Drupal 7.x: {mauticform id =ID# width=300 px height=300 px}.
Be sure to change the width and height to the appropriate sizes for the space
you’d like the form to display.
Important
This shortcode doesn’t work for Drupal 8.x. Acquia recommends using the Automatic Copy option instead.
Joomla!: {mauticform ID#}
Wordpress: [mautic type="form" id=ID#]
The Automatic option keeps your forms updated wherever you use this code.
If you make changes to the form in your Campaign Studio instance, you don’t need to worry
bout re-copying the code everywhere the form appears on your site. Features like
autofill and progressive profiling will work only with the automatic copy
options, not with manual copy. First, if you have a custom domain for your
instance, be sure you’re logged in using the custom domain
rather than subdomain.mautic.net.
Via JavaScript: Other than shortcodes, this is the recommended way to add forms to pages. Copy the line of code in the box and paste it into your website where you’d like the form to display.
Via iframe: While there may be cases where using an iframe is preferred for
page load time or styling, iframes can be more difficult to manage. Be sure to
adjust the width and height for the space you’d like the form to be in.
Depending on the size of the screen your contact is using, they may still need
to scroll within the iframe on your page to see all the fields. You may enter a
custom error message to display in place of the form, in case the contact’s
browser doesn’t support iframes. To do so, edit the text between the <p>
and </p> tags before copying the code and pasting it on your website where
the form should display.
The Manual copy option gives you a little bit more flexibility to extend forms with JavaScript snippets and custom styling. It’s more manual, and any changes made to the form won’t display on your page unless you re-copy and paste the HTML code. Be sure you’re logged into your instance using your custom domain, if you have one.
If you’re a Campaign Studio Cloud subscriber and have more questions about forms, contact Acquia support.
53 State Street, 10th Floor
Boston, MA 02109
United States
Phone: 888-922-7842