Articles in this section
Authenticate Emails with SPF, DKIM, and SenderID Auto forward your emails to Vtiger Automate Outgoing Emails in Email Settings Managing User Profiles Automation - Approvals Automation - Assignment Rules Set up Multi-path Workflows Creating a Scheduled Workflow Automation - Workflow Scheduler Workflows in Vtiger CRM Set up a Workflow Action to Create Event Set up a Workflow Action to Create Records Set up a Workflow Action to Create Task Set up a Workflow Action to Invoke Custom Function Set up a Workflow Action to Create an SMS Task Set up a Workflow Action to Send Mails Workflow Action to Update Fields Automation - Webhook Workflow Automation - Expressions Workflow Configuring Business Hours Configuration - Company Details Configuration - Consents Configuring the Customer Portal Maps in Vtiger CRM Configuration - Usage Details Configuring Encrypted Data Fields in Vtiger CRM Configure Picklist Dependencies Considerations for Deactivating Vtiger Users Configuring Field and Record Displays Create Reminders for Records and Inbox Create a field of a Grid type Dealing with Currencies and Taxes Enable Desktop Notifications on Chrome Web Browsers Vtiger CRM Add-ons IMAP Configuration - 2-way sync between Vtiger and IMAP providers Setting up Autopay & Payment Gateways Inventory - Tax Management Inventory - Terms and Conditions Login to Vtiger on SSO SAML using ADFS Mailroom Functionality for Different Scenarios Manage Multiple Currencies Marketing and Sales - Deal to Project Mapping Lead Conversion Data Mapping Marketing and Sales - Profile Scoring Configuring Module Labels Editor Configuring Module Numbering Configure My Preferences Feature My Preferences - Calendar Settings Tags in Vtiger My Preferences - Notification Preferences SAML Support in Vtiger CRM Vtiger Mailroom Settings - Create Dynamic Fields and Layouts Configuring a Relationship Between Modules Settings - Customize Records and Fields for your Business Settings - How to set email autoresponder to Webform submission? Settings - Left Menu Settings - Manage Global Picklists in Vtiger Settings - Set up your Support Team Settings - Start Up Page Settings - Working with Picklist Values Configuring Modules Using Module Builder SLA Policies in Vtiger Troubleshooting Login Issues Add-Edit Unsubscribe Links in your Email Template User Management - Authentication User Management - Encrypted Field Access Logs User Management - Groups User Management - Login History User Management - Profiles User Management - Roles User Management - Settings Log User Management - Sharing Rules User Management - Users User Management - Vtiger Support Access Vtiger Buzz - Chrome Extension for Notifications Vtiger Implementation wizard Vtiger Language Support Configuring Websense Trackers Vtiger Websense Widgets Configuring Module Layouts & Fields Personalizing Module Layouts Adding Custom Module Auto forward Emails from Microsoft Office 365 Automation - SMS Reply Actions Duplicate Record Prevention in Vtiger CRM Generate and Manage Third-party App Passwords in Yahoo Configuring App Passwords for Gmail Outgoing Server and Yahoo Mail Configuration - Storage Guard Customizing your Self-Service Portal Theme Using CSS Styles Adding Hidden Fields to a Webform Configuring Dependent Fields and Blocks for Modules Login Page Customization Formula Fields Creating Custom Filters Adding a local DNS Entry

Vtiger Webforms

Learn to set up webforms to capture and store information seamlessly!
R
Ruba
10 Dec, 2025 - Updated  1 day ago

Feature Availability 

Vtiger Editions: One Pilot | One Growth | One Professional | One Enterprise | One AI

Introduction

Vtiger Webforms are HTML forms that you add or embed on your website. Whenever a website visitor fills out the form, you can:

  • Capture data such as visitor details, customer feedback, or vendor information. 
  • Automatically import data into the CRM and store it in the relevant CRM module, such as Leads, Contacts, Deals, or Cases. 

Example: A customer ordered a pair of headphones from Grasspods Audio Equipment, but they arrived damaged. The customer visits the My Orders page and fills out a web form to report the issue. Once submitted, a case record containing all their details is automatically created in the CRM. You can then review this record and take appropriate action to resolve his problem.

Benefits of Webforms in Vtiger CRM

The benefits of using Vtiger Webforms are:

  • Capture and store user information automatically in your CRM.
  • Save time by eliminating manual data entry.
  • Use structured fields and validation checks to collect accurate and relevant data and minimize mistakes.
  • Capture leads directly from your website, converting visitors into potential customers.
  • Boost lead generation, manage customer service requests, and track vendors, turning website interactions into actionable insights.

In this article, you will learn about:

  • Creating a Webform
  • Adding a Webform to the Website
  • Obtaining Consent through Webforms
  • Integrating Existing Webforms
  • OTP in Vtiger Webforms
  • Blacklisting Spam IDs for Webform
  • Troubleshooting tips

Key Terminology

 

Field Name

Description

Webform

A webform is an online form used to collect and submit information.

Webform Name

Webform name for your reference

Primary Module

Module in which a record must be created. The available modules are Leads, Contacts, Organizations, Deals, Cases, and Vendors.

Return URL

URL to which users must be redirected after successfully submitting the webform.

Secondary Modules

Modules related to the primary module, in which a record must be created

Assigned To

CRM User or a group to whom the records created from the webform are assigned. Note: Records are assigned to this user only when Round Robin Assignment is disabled.

Campaigns List

Available only if the Primary Module is Leads or Contacts. Leads and contacts are added through a webform as linked to the campaign(s) selected here

Status

Webform is active if the status checkbox is enabled. Otherwise, it is inactive

Captcha Enabled

Enabling a captcha prevents bots from generating unnecessary leads through your web form due to automated scripts

Description

Webform description for your reference

Public ID

Helps in integrating your existing web forms with Vtiger. It is available in Webforms’ List View.
 

Creating a Webform

Follow these steps to create a Webform:

  1. Log in to the CRM.
  2. Click the User Menu in the top right corner of the CRM screen.
  3. Click Settings.
  4. Go to Automation > Webforms. The webforms page opens.
  5. Click +Add Webform. The Adding new page opens.
  6. Enter or select information for the sections below while creating a webform.
    1. Webform Information 
    2. User Assignment
    3. Webform Field 
    4. Additional Hidden Field
    5. Upload Documents
We will learn more about each of these sections in detail.

Webform Information Block

Enter or select information in the Webform block:

  1. Webform Name - Webform name for your reference.
  2. Primary Module - Select the Module(e.g., Leads, Contacts, Organizations) where you want a record to be created when the webform is submitted.
  3. Return URL - The web page URL where users will be redirected after successfully submitting the webform.
  4. Secondary Modules - Modules related to the primary module, in which a record must be created.
  5. Assigned To - The user or group in the CRM to whom you want the records created from the webform to be assigned.
    1. Note: Records are assigned to this user only when Round Robin Assignment is disabled.
  6. Campaigns List - If Leads or Contacts is the Primary Module, the webform submissions can be linked to one or more selected campaigns.
  7. Status - Webform is active if the status checkbox is enabled. Otherwise, it is inactive. 
  8. Captcha Enabled - Enabling a captcha prevents bots from generating unnecessary leads through your web form due to automated scripts. 
  9. Description - Provide a brief note or explanation about the webform for internal reference.

User Assignment Block

The User Assignment section enables you to assign webform records to CRM users using the Round-Robin method, distributing records evenly in a set order. For example, if the users are Samuel Johnson, John Doe, and Rahul Kapoor, the first record goes to Samuel, the second to John, the third to Rahul, and then the cycle repeats.

Follow these steps to enable round-robin assignment:

  1. Assign Users in Round Robin - Enable the checkbox to assign the records using the Round Robin method.
  2. Round Robin user list - Select users or groups from the drop-down to assign records.

Note: If a user is specified in the Assigned To field with Round Robin enabled, the record will be assigned through Round Robin instead of to the Assigned To user.

Webform Fields Block

This block allows you to select the fields that will be displayed in your Webform.

Enter or select information in the Webform Fields block:

  1. Add Fields - Select the fields from the drop-down menu that you want to appear on the webform. You can reorder the fields using drag-and-drop.
    1. ​​​​​You can use the Multi-select Combo Box field type to allow users to select multiple values using a drop-down with checkboxes. This is useful for scenarios where users must choose multiple options, like selecting preferences or interests.
  2. Mandatory Field - Enable the checkbox to make a field mandatory, ensuring users can only submit the form after completing it.
  3. Hidden Field - Enable this option to hide the field from the web form. The value set in the override value will be automatically pre-filled and saved when the form is submitted. For example, if the Organization field is hidden and the override value is set to Apex Pvt, then every time the form is submitted, the Organization for all records will be stored as Apex Pvt, even though users didn't see or fill in that field.
  4. Field Name - The fields added will be listed here.
  5. Webforms Reference field -The name assigned to the field in your CRM for reference purposes.
  6. Duplicate Handling - Choose how to handle duplicate record submissions from the webform. You can select from the following options:
    1. Keep existing value - This option retains the existing values in the CRM. If a field has no value, the submitted value is considered.
    2. Use non-blank submitted value - Replace the CRM value with the submitted value, but only if the submitted value is not blank.
    3. Append to existing data - Adds the submitted value to the existing CRM value. In this case, you must set up a Concatenation Separator (under Settings > Configuration > Configuration Editor) to separate the new data from the existing value.

Note: When adding a contact field during web form creation, a dropdown to select the country code will appear in your webform.

Additional Hidden Fields

Hidden fields are added to a webform to capture data without user input. They can hold a set override value or dynamically pull data from URL parameters like user IDs or campaign info.

Follow these steps to add Additional Hidden fields:
  1. Add Fields - Select the field from the drop-down that should be hidden. These fields will not be visible to users in the webform.
  2. Field Name - The list of hidden fields selected will be listed here.
  3. URL Parameter - A URL parameter is a value added to the webform's URL that automatically populates hidden fields with specific data. 
  4. Override Value - The value assigned to hidden fields in the webform that will be included upon form submission.

Review the following examples.

  • If you set the campaign as a hidden field and use campaignid as the URL parameter. When an override value (e.g., 123) is assigned, the hidden field (campaign) will always use this value, regardless of any campaignid value in the URL.
    • Example :
      • URL: example.com/form?campaignid=456
      • Hidden field campaign value on submission: 123 (override value)
  • If no override value is set, the hidden field (campaign) will capture the exact value provided in the URL parameter (campaignid).
    • Example: 
      • URL: example.com/form?campaignid=456
      • Hidden field campaign value on submission: 456 (from URL parameter)

Note: 

  • If any fields are added in Webform fields and marked as mandatory, they cannot be added to the hidden fields.
  • Add only the English alphabet, numbers, and underscores to the URL parameter.

Upload Document

You can provide a field to allow web form users to upload documents and files from the webform. 

Follow these steps to provide an option to upload documents:

  1. + File Upload Field - Click the button to add a new file.
  2. Document Title - Provide a name to the field shown in the webform.
  3. Mandatory - Mark the field as Mandatory by enabling the checkbox. 
  4. Actions - Click the Delete icon to remove the field.
  5. Click Save.

After saving the webform, it will be available in the webforms module of the CRM.

Adding a Webform to a Website 

Adding CRM webforms to your website is easy and helps collect customer data directly into your CRM system. With just a few quick steps, you can embed these forms to keep customer records automatically updated.

Follow these steps to add a webform to your website

  1. Log in to the CRM. 
  2. Click the User Menu on the top right corner of the CRM screen.
  3. Go To Settings > Automation > Webforms. The Webforms page opens. You can copy the HTML code in either of the following ways:
    1. Click on the Get form code icon by hovering over the Webform. A page with HTML code opens.
    2. Open the respective Webform and click on the Get form code icon. A page with HTML code opens.
  4. Click Copy to clipboard.
  5. The webform code gets copied. You can paste it into your website’s source code.

Note:

  • To test a webform, copy its code from the CRM and paste it into a text editor such as Notepad++, etc. Save the file in .html format. Open the HTML file to check how the webform appears. The HTML file opens in your web browser.
  • Records created through webforms are connected to existing records in the CRM. For instance, when an existing contact submits a webform to create a case, it will be linked to their contact record in the CRM.
  • You can also integrate the webforms into WordPress easily. Click here to learn more.

Obtaining Consent Through Webforms

Consent for marketing emails is crucial when collecting contact details through web forms. Vtiger CRM ensures users' consent to receive emails by automatically adding an Email Opt-in field whenever a Primary Email field is included in web forms.

Primary Email and Email Opt-in Field


When you add a Primary Email field to your webform, an Email Opt-in checkbox is automatically included. This checkbox ensures that users can grant permission to receive marketing emails. For example, if you’re gathering leads through a webform, the email field will always include the option for the user to opt in or out of receiving marketing messages.

To learn more about email opt-in and marketing emails, click here.

Webforms for Non-Personal Modules

When creating webforms for non-personal modules like support cases (e.g., customer support forms), the Email Opt-in field is automatically added if you collect a contact's email address. This ensures that, even if the webform isn't intended for marketing, you still capture consent if you decide to send marketing emails later.

Note: 

  • A hidden checkbox cannot be enabled for the Email opt-in field. When a customer submits a webform and does not enable the Email Opt-in checkbox, the CRM's opt-in value is set to None. 
  • Vtiger retains the existing value of the Email Opt-in field when an existing contact submits a webform without checking the email Opt-in checkbox.

Integrating Existing Webforms

If you already have webforms on your website for various purposes, you can integrate them with Vtiger CRM to automatically store the submitted data in Vtiger. 

Follow these steps to integrate existing webforms:

  1. Create a new webform in Vtiger that aligns fields with the Existing Webform that you want to integrate.
  2. Once you finish creating the webform in Vtiger, you can open the HTML code in either of the following ways:
    1. Click on the Get form code icon by hovering over the Webform. A page with HTML code opens.
    2. Open the respective Webform and click on the Get form code icon. A page with HTML code opens
  3. Copy the following HTML code and paste it into your existing webform HTML code:
    1. The Form Action URL specifies the endpoint where the form data is sent upon submission. It is crucial to ensure that the data is processed correctly by the Vtiger CRM. 
  4. The Public ID uniquely identifies the specific webform in Vtiger CRM. It ensures that the submitted data is associated with the correct module.
  5. Modify the field names in your existing webform to match the reference field names in Vtiger webforms. You can find the exact field names (like firstname for First Name and email for Email) by referring to the Field Information block in the Vtiger webform you create

After making these changes, when users fill out and submit the existing webform on your website, the data will be automatically sent to Vtiger CRM and stored in the module you selected while creating the Webform.

Adding OTP to Vtiger Webforms

This Add-on improves your web forms by reducing spam and verifying submitted information. When a visitor fills out a form, they must provide a valid contact method. This triggers an OTP (One-Time Password) that they must enter to complete their submission, filtering out spam bots and ensuring accurate contact details.

Follow these steps to add OTP verification in Vtiger Webforms:

  1. Log in to your CRM account.
  2. Click the main menu. 
  3. Click Add-ons at the bottom of the menu. The Add-on page opens.
  4. Search for OTP in Vtiger Webforms in the search bar.
  5. Click Install.
  6. After installing, click the User Menu in the top right corner of the CRM screen.
  7. Go to Settings > Automation > Webforms. The webforms page opens.
  8. Click and open an existing webform or create a new one by clicking +Add Webform. A new section called OTP Verification will be added.
  9. Enter or select the following information for OTP verification
    1. Email-based Verification
    2. SMS-based Verification
  10. Choose the Email/SMS field to which the OTP should be sent.
  11. Click Save.

OTP verification will now be integrated into your webforms. Your customer, contacts, etc., will be expected to enter the OTP when filling out the webforms to submit them.

Blacklisting Spam IDs for Webforms

The Blocked IPs List feature in Vtiger CRM helps prevent spam by automatically blocking IP addresses known for unwanted submissions. If an IP is detected as spam, it is immediately added to the blocked list, and the admin receives a daily email summarizing all blocked IP addresses. The admin also has the option to manually unblock any IP addresses if needed, ensuring better control over web form submissions.

Follow these steps to manage the blocked IPs list:

  1. Log in to the CRM. 
  2. Click the User Menu in the top right corner of the CRM screen.
  3. Click Settings.
  4. Go to Configuration.
  5. Click Blocked IP. The Blocked IP’s page opens. 
  6. You can view the following information on this page:
    1. Blocked IP Address - IP addresses added to the Blocked IPs list will be displayed, and any web form submissions from these addresses will be automatically rejected.
    2. Records Created - The number of records created after the IP address is unblocked.
    3. Blocked Webform Requests - The total number of webform submissions denied because they came from blocked IP addresses.
    4. Action - Options to manage the blocked IP addresses, such as blocking or unblocking existing ones.
    5. Add Blocked IPs -This button displays a pop-up window for adding and saving an IP address to the Blocked IPs List.
    6. Logs - Page that shows data from the past seven days of webform submissions, including rejected entries due to blocked IP addresses.

Troubleshooting tips

  • Form Not Submitting:
    • Ensure all mandatory fields are filled in.
    • Verify that CAPTCHA or OTP verification, if enabled, is working correctly.
  • Data Not Syncing to CRM:
    • Confirm that the webform's Public ID and Post URL are correctly set in the form.
    • Ensure that field names in the form match the corresponding CRM field names.
    • Verify module configurations, especially Primary and Secondary Modules.
  • Duplicate Record Handling Issues:
    • Check if duplicate handling settings (e.g., Keep existing value, Append to existing data) are correctly configured.
    • Review if records are being overridden based on CRM settings for duplicates.
  • Round Robin Assignment Not Working:
    • Ensure the Round Robin option is enabled in the User Assignment section.
    • Confirm that selected users or groups are correctly listed in the Round Robin User list.
  • Hidden Fields Not Populating:
    • Verify that the override value is correctly set for hidden fields.
    • Ensure that the URL parameters are formatted correctly when passing values to hidden fields.
  • Unable to Upload Files:
    • Ensure the file upload field is added and marked as mandatory if required.
    • Verify file type and size restrictions are set correctly and communicated to users.
  • IP Address Blocked:
    • Check if the user's IP is on the Blocked IPs list and remove it if needed.
    • Review the logs to determine if security features like CAPTCHA triggered the block.
  • Webform Not Redirecting After Submission:
    • Verify the Return URL is entered correctly and points to a valid, accessible page.
    • Ensure no typos or incorrect URLs are causing redirection failures.

Reference

Integrating Vtiger Webforms with WordPress

Home Privacy Policy Terms of Service Security Center Policy & Legal Center Contact Us
© Copyright 2025 Vtiger. All rights reserved.
Powered by Vtiger
Facebook Twitter Linkedin Youtube