FORMS: Kickoff Forms

What is a Kickoff Form?

Instead of manually adding Contacts into your CRM, you can provide a Kickoff Form for your Contacts to fill out and add themselves into the platform. You can also create an Approval process by choosing not to send the Portal Access Invitation immediately so that you can send it after review of the registration submission. Existing Contacts can also complete a Kickoff Form to update their information. You can also have a Staff Member fill out the Kickoff Form in lieu of the Contact; more information is in the sections below.

CLICK HERE to learn about Client/Prospect Approval Process

Kickoff Forms can be embedded inside the Portal, but typically you would embed one externally, such as on a page on your website, or provide a link.

Potential Contacts can also register with an associated Company, including as a Primary Contact. 

You can also use a Choice Block to customize a Contact's registration based on their choices!

CLICK HERE to learn about types of Forms.

How do I create a CRM Kickoff Form?

Navigate to the menu item, and click +Create Form.

You will then be able to choose Kickoff Forms. Alternatively, you can click the icon beside the +Create Form button and choose from the dropdown menu.

From here, you will be able to build your Kickoff Form.

Start by giving your Form a Title. By default, "Untitled Form" is populated into this field.

Allow the Contact to Save Form as Draft

  • You can decide if you'd like to offer the option for your end user to save the Form as a Draft. If enabled, the Target will see a "Save Draft" button alongside the "Submit" button whenever the Form is displayed. 
  • The Target can save a partially completed form as a Draft and return to it at any time to complete the Form. Be aware that this feature uses cookies to accomplish the goal, so if the Target clears browser cache or prevents cookies, this feature may not work as intended.

Form Header and Footer

You can add HTML content above the Form as a Header and below the Form as a Footer. 

To add a Header or a Footer, click the relevant arrow to reveal the HTML Content Block. 

This will enable you to insert text, images etc as the Header or Footer.

Alternatively, you can also click the CSS Class block if you would like to add CSS.

Building your Form Fields

You'll see an initial set of Form Blocks by default. These are required for all Kickoff Forms and cannot be removed, but you can rearrange the order and change the name of the fields.

Each default or custom Form Field will display icons to help you quickly identify what type of field it is. 

CLICK HERE to learn about Form Field Icons.

How do I associate a Contact with a Company?

Your Contact may or may not be associated with a Company, so if you want to ask for a Company, you'll need to take these steps to insert a Company field into your Form.

First, you'll need to select the Company Name field from the CRM Contact Fields dropdown menu. This will associate the Contact with the Company.

When the field is added to the list, click the arrow icon to expand the pane.

From here, you have a variety of configuration choices;

Select a single existing Company and add all Contacts to that Company

  • If you want every Contact that completes the Form to be added to a Company that already exists in your CMR, then you should select that Company from the drop-down menu. This may be useful if you are creating a dedicated Company-specific Form that will add every Contact to a single specific Company. This is likely not a common use case, but it is supported in this way.

Allow the Contact to freely type in their Company Name

  • If you want the Contact to have the ability to freely type out their Company name, then you should toggle ON the "Allow open-ended input of Company name". Understand that the platform does not offer an option for the Contact to choose from existing Companies in the CRM because this would expose all the Companies in your CRM to the public, and every person who can view this form.
  • When you allow the open-ended input of the Company name, the platform will attempt to match what is typed with existing Companies in your CRM. Please see below to understand the "Company Match" option and how it's used.  With this option enabled, there is the possibility of duplicate Companies (depending on the Match Value % that you choose).

TIP : In CRM > Settings > Company Settings, you can change the Company Match Option setting to your desired value.

Allow open-ended input of Company name 

  • Enabling this feature will automatically insert a Company field into your Form. When filled in by the Contact, they will be associated with that Company if a close enough match is made. This allows for variations and typos.
  • By default, enabling this option will NOT create a new Company if no match is detected. This is useful if you would rather manually create the new Companies as needed.

Create Company if no match can be made

  • When the Company field is filled in by the Contact, if no matching Company is detected a new one will be created. When a new Company is created via this logic, the Contact completing the Form will automatically be assigned as the Primary Contact.

Use the Company as the "Target" for any Assignments and/or Automations

  • When you enable this setting, all Assignments and/or Automations will target the Company instead of the Primary Contact (the individual).
  • This means that if the Form is configured to Add to Circle(s), trigger an O-D Invoice Generator, add to Marketing Audience, etc... all of those Assignments and Automations will be targeted towards the Company.
  • When the Primary Contact enters the Portal (if you invite them), they will enter as the representative of the Company.

Prevent this Primary Contact from switching into "Individual Mode"

  • Clicking this setting will prevent the Primary Contact from switching into Individual Mode. This means that the Portal they enter and navigate is the Company Portal and they will not be able to switch to their Individual portal in the Flyout Menu.
  • The option to 'Prevent this Primary Contact from switching into 'Individual mode' will only work for Unknown Targets.  Any Primary Contacts that are already in the CRM will not be affected.  To change Known Contacts, please execute this in the Contacts Profile or via Bulk Edit.
  • If 'Prevent switching' is enabled, the Primary Contact will be hidden from all areas of the Platform except for the Contact List.  This is to prevent Automation and Assignments being accidentally applied to the Individual Primary Contact rather than the Company.

IMPORTANT: If you manually create a Custom Field, call it "Company" and then add it to the Form, it will not work in the way described above. You must use the default Company field provided by the platform. Please use the toggle option detailed above to include the Company field into the Form.

CLICK HERE to learn about preventing a Primary Contact from switching into ‘Individual Mode’.

Custom Fields

Use the dropdown menu to choose Custom Fields to add to the Form. Any Custom Fields you have already created will be in the list. You can also click Create Custom Field to create new ones.

The dropdown arrow for each CRM Custom Field will show will show all Default Fields and Custom Fields that are already available for the Custom Field Type, whereas Project Custom Fields only show Custom Fields as there are no Default Project Fields.

To add additional Custom Fields click the + button next to the required Custom Field Type and add your details. 

Once you add the field, you can rearrange the order by clicking the three bars and dragging them into place. You can delete a field by clicking the red x icon.

CLICK HERE to learn about Custom Fields.

To configure settings for a field, click the arrow.

Required: This field will be required to have input and the user will be unable to submit the form until it has been filled out.

Placeholder: The field will be open for any data input.

Pre-Fill Value: The value you input into the provided field will be shown by default.

Read Only: The field will be seen by the user, but no action will be needed.

Hidden: The field will be hidden from view and the user will be unable to input any data into it.

Subtext: This is a secondary title for the field. You can use this to fill in a description, give an example, or for general information you think would be useful to your Contact filling out the Form.

Selection Actions: Form Field Choice Actions are available for Radio Button, Checkbox, and Dropdown Selection Custom Fields. 

CLICK HERE to learn about Form Field Choice Actions

CSS Class: This field allows you to add your own custom CSS class to the Form Field. You can then target this class in Custom CSS on the Link/Embed tab. You can have multiple classes per field but you will need to separate each class with a comma. Let your imagination run wild!
CSS ID: This field allows you to add a CSS ID to your Form Field. You can then target this ID within your Custom CSS on the Link/Embed tab.
Field Styling & Layout Classes: This section contains pre-made CSS classes that will allow you to customize your fields without having to do the code yourself! See the section below for more information.

Field Styling & Layout Classes

Below are the classes that are available for you to use. You can have up to 4 columns per row and you can even mix & match as long as the percentages equal 100%. We also have some style classes that will allow you to add emphasis to the important fields.

field_first - Required in the first column of a row when using these classes to make multiple columns.
field_half - Directs a field take up 50% of the available width in a row
field_third - Directs a field take up 33.3% of the available width in a row
field_fourth - Directs a field take up 25% of the available width in a row
field_cb - Places a light grey background behind the field and some added padding
field_important - Places a soft red background with red border and added padding

Usage Guidelines
Example: For two fields on the same row, the field you want on left should have two classes, separated by a comma: field_first, field_half / The field on the right only requires one class: field_half / You can mix & match the classes as long as it adds up to 100% in a row. Remember that the first field in any row should also be given the "field_first" class, separated by a comma.

How Can I use Project Custom Fields?

You can use the Project Custom Fields dropdown to select a Project Custom Field that you created earlier using Custom Fields or you can create a new one by clicking the + button. 

Once you have selected your Project Custom Field from the dropdown you can determine what Project the Custom Field will be added to, by clicking the  Apply To dropdown.

Unknown Target

  • Project Generator - Select the Project Generator in the Project Generator Field. This option is the only option for Unknown Targets.

Known Targets

There are three different options for Known Targets.

  • Project Generator - Select the Project Generator in the Project Generator Field.
  • Contact's most recent Project - This selection will add the Project Custom Fields to the most recent Project.
  • Project Title Starting with the following - This selection will provide a Search Box so you can select the relevant Project Generator.

    Advanced Blocks

    You can use the Advanced Blocks dropdown to select a Content Block to insert before, after, or between fields in the Form.

    More information on HTML Content Blocks, Appointment Blocks, Choice Blocks, and Signature Blocks in the following sections.

    Choice Block: How do I customize a Contact's registration based on their choices?

    You can insert a Choice Block to allow a Prospect or Client to choose different paths while registering. For example, you could set up a choice of different Subscription Plans with varying prices. Or, you could add the Contact to different Circles with unique viewable content depending on their choices.

    In action, this Block will appear as a dropdown menu for the user to select from. How they will be registered into the platform will depend on which option they choose.

    Select Choice Block from the Advanced Blocks dropdown menu.

    Once selected, the Block will automatically be added to the list above with one Choice by default.

    IMPORTANT: When you add a Choice Block to the list, the "Form Actions" section will be removed. Instead, you'll be filling out this information for each Choice by clicking the gear icon next to your Choice options.

    Click the icon to configure what will happen if the Contact makes this particular choice. This is similar to filling out a Kickoff Form in which you choose the Contact's Role and Coordinator, and optionally assign them to a Circle, apply a Folder Generator, etc.

    Click the Add New Choice button to add additional Choice Sub Blocks.

    In practice, "Choice Block" will be the title of the field, and the Choice options will represent what you can choose from the dropdown menu.

    TIP: You can give Contacts the ability to schedule Appointments with specific Appointment Types in each Choice option. In order for this option to appear, you will need to add an Appointment Block to the list of Forms Blocks first.

    HTML Blocks: How do I add my own content in addition to form fields?

    You can insert HTML Content Blocks that you can use to insert text, images, videos, etc. into the Form. You can place these blocks before, after, or even in between fields and can add as many as you'd like.

    Select HTML Content from the Advanced Blocks dropdown menu.

    Once selected, the Block will automatically be added to the list above.

    Once added, click the icon to expand the pane and click the Edit Content button.

    A standard WYSIWYG editor will appear in which you can add content. Click the  <> icon to switch to HTML.

    You also have Embedded Options.  You can toggle to hide the content when embedded or toggle to only show for a Staff Submit.

    Signature Block: How do I add a signature area field?

    You can use a Signature Block in Forms to easily & quickly get important sign-off on agreements, policies, or authorizations

    Get started by opening Advanced Blocks and selecting the Signature Block

    After you have added the Signature Block, click the arrow to customize the text/labels that appear on the front end of the Form.

    You can add multiple Signature Blocks to the Form and you are able to customize each one separately.

    Ordering of the Form Fields

    When adding Form Fields you can then re-order the Fields.  To do this, either click the three lines and drag and drop the field into the correct order;

    or click the Form Field number and change it to the correct order number;

    Contact Details for "Unknown" Targets

    A new user who is filling out the Kickoff Form is an "Unknown" Target. This Target is not yet in your CRM but will be added once they complete the form.

    You'll need to set how this new Contact will be entered into the CRM.

    IMPORTANT: You'll need to decide if you want to implement a Choice Block into your form before filling out this section. If you add a Choice Block, these sections will disappear and will instead need to be configured within each Choice Sub Block.

    You are required to choose a Role and a Coordinator for your potential Contact. The  Assignments/Automation options available will depend on which Role you choose. 

    You can also choose to assign the Contact to a Salesperson.

    CLICK HERE to learn about Salesperson Visibility

    If you set the Role as Prospect or Client, you will have the options to Send Portal Access Invitation Immediately.

    If you choose Client as the Role, you will also have the ability to enable Paid Portal Access, located in the bottom section. This will require Clients to pay before accessing the platform.

    CLICK HERE to learn about Paid Portal Access

    Contact Details for "Known" Targets

    An existing user is a "Known" Target. This Target is already in your CRM.

    You can have an existing Contact's information updated as a result of completing this form. If you would like to use this Kickoff Form for role changes you can convert a Lead to a Prospect or Client and a Prospect can be converted to a Client. 

    If you would like to update the Contact's Coordinator or Salesperson assignment you can do so here.

    You can also trigger assignments to the Target, such as an Event Generator, Email Marketing Audience, Project Generator, and more. 

    If the Known Target is a Prospect or Client an On-Demand FLOW will be an option as well. 

    You can choose to send an email to the Coordinator when the Known Target completes the Form. You can also choose to send Portal Access Immediately. Don't toggle this on if you want to send the Welcome Email manually or via an Automation.

    How do I send Email Notifications?

    Click the +icon at the bottom of the Form to reveal the Send Email Notification button.

    You can assign the Email Notification to one or many Users;

    If you choose to send an email notification there is a toggle that allows you to send it to the Target of the Form. When toggled off you can select multiple users to send the notification to.  

    In the body of the email you can customize your message and use {X} Placeholders to send specific information including form field data. 

    Additionally, you have a toggle for 'Attach the Form Submission PDF' if you would like to include a copy of the Form submission with the email.

    How do I configure Conditional Logic for Fields?

    Conditional Logic allows you to create a Form that changes based on user input. Depending on what the Target (user who is filling out the Form) enters into a field, it can trigger whether or not to Show or Hide a different field.

    All Custom Fields (with the exception of the "File Upload" type) can be configured to trigger Conditional Logic. The Appointment Block can also be configured with conditional logic. This allows you to hide the Appointment Block on a Form so it only shows up if the Target completed the necessary requirements.

    While in the editing screen, you'll see a tab to the right of the screen with a icon. You can click on this at any time to open a side panel, in which you can then configure your Conditional Logic.

    CLICK HERE to learn about Conditional Logic

    How do I Change the Welcome Email?

    On the right side, you will see a button with an envelope icon. This is where you can edit the Portal Access Invitation.

    Your saved Portal Access Invitation for Internals and Externals will still remain in Email Templates, but this allows you to change the Welcome Email specifically for the Kickoff Form you are working in.

    CLICK HERE to learn about Email Templates

    You can edit this template just like you would any of the emails in Email Templates. Keep in mind that this Portal Access Invitation is only for the Form you are currently working on. Any edits made here will not affect your Portal Access Invitation Templates in Email Templates.

    How do I Switch between Forms?

    On the top right you will see a dropdown. It will be titled the name of the current Form you are working on. You can easily switch to a different Form and a different Form type by clicking on the dropdown and selecting one from the list.

    How do I use/embed/link a CRM Kickoff Form?

    On the Link / Embed screen, you will have two options to share your Form. These options are Direct Linking via URL, Direct Linking via QR Code, or by embedding on your external website or internal content pages via HTML or Placeholder. 

    Direct Linking Options

    The first option you will see is Direct Linking options and settings for Friendly URL.

    Here you can set your preferences on how you will link to your Kickoff Form.

    Direct Link: Simply copy this link and share it wherever you'd like. This code is pre-generated and can not be updated. If you have a Custom URL, this will reflect your set domain.

    QR Code: You can select the Display QR Code button to open the sidebar details with your QR Code and download options for PNG and SVG. You can customize the look of your QR Code in Platform Branding.

    CLICK HERE to learn about QR Code Customization

    Friendly URL: If you have your Custom URL configured, you can create a Friendly URL.

    CLICK HERE to learn about Friendly URLs

    Embed Options

    Embed Code: Use this html code to embed your Form outside of the platform, such as a page on your website.

    Embed Placeholder: Use this placeholder code to embed your Form within the platform. such as a Portal Page.

    Width: Set the Width and Height of your Form when it is embedded using the Code or Placeholder.

    How do I Submit a Form for a Contact?

    In some cases, you may want to fill out a Kickoff Form in place of the Contact. A customer may call you on the phone, for example, and have you set up their account for them. This is where Staff Submit comes in.

    In the Forms ListView, just click the Options menu button and select Staff Submit.

    This will open the Form in a new tab for you to fill in the details. The Contact will be added to the CRM just as if they had filled it out.

    How do I view submissions for my CRM Kickoff Form?

    While viewing Forms, click the Options menu button and select Submissions.

    Alternatively, you can click the Submissions button while editing the Form, located on the right-hand corner of the screen.

    The precise date of each submission is displayed.

    To view the submissions, just click directly on the row, or click the Options menu button and select View.

    Click the Options menu button to view, download a PDF version, or delete the submission.  This will not delete the Contact.