Use Webforms to create forms that can be embedded in your website. Using these, customers can enter and submit data to Zoho FSM. You can easily design and customize the form to suit your specific needs. Thus, webforms enable you to create a communication channel through which you can interact with your website visitors and customers in a structured and efficient manner. For example, you can add a webform to your website through which your customers can submit a request to Zoho FSM.
Available in Editions: Standard, Professional, Premium
- Find out the Edition-specific limits for
Webforms.
To create a webform:
- Go to Setup > Channels > Webforms and click Create Webform.

- Enter the following details, then click Add Form:
- A Name for the webform
- A Description for the webform
- The Module for which you want to create the webform.
Webforms are currently only supported in the Requests module.

- Add the necessary Form Details and click Next.
- Provide the required information in the Webform Details page and click Save.
- Click Get Code.

- Click Close.
The source code of the webform will be displayed. Click Copy the source code and embed the code in your website. Refer to the example for details.
- Drag and drop the necessary fields from the Fields tray on the left. Any custom field added to the Requests module will also be available in the Fields tray.

- You can set the following properties for the fields:
Mark as hidden field: If you set this property, the field will not be displayed in the form. You can assign a value for the field which will be used to populate the field when the form is submitted. E.g. use a custom field named Source and set its value as Webform to indicate the request origin.

Mark as Mandatory field: Use this property to mark the field as required.
This property cannot be modified for some default fields (like Summary in the Requests module) that are integral for the working of the module. Based on the sync type between Zoho FSM and Zoho Books/Invoice, this property cannot be modified for Contact Last Name, and/or Company Name.
Module
| Sync Type
|
Type I
| Type II
| Type III
| Type IV
|
Requests
| Company Name
| Contact Last Name
| Company Name
Contact Last Name
| Contact Last Name
|
- You can add the following Advanced fields to the webform:
Privacy Policy: Include this if you want your customers to agree to a set of legal agreements or rules before they can submit the form. To edit the privacy policy, click on the Field Properties pane on the right and click on Policy Content to open the text editor. You can also edit the source code of the webform to include your legal agreements or rules.

Standard Captcha: You can include this to ensure that only real human beings and not bots or malicious software submit entries through your form.
Attachments: Include this if you want your customers to be able to upload files/images from the form. A maximum of five files can be uploaded at a time. The maximum allowable size of an attachment is 10 MB. The files uploaded from the form will be added to the Attachments tab of the request created.
- You can remove any field by clicking the more options [
] icon for a field and clicking Remove. You can also delete a field using the Delete [
] icon at the bottom of the right pane. The removed field will be moved back to the Fields/Advanced fields tray. You can also drag and drop a field to Drop here to delete located at the bottom of the Fields/Advanced fields tray.

Any field marked as mandatory cannot be deleted. You will have to remove the Mark as Mandatory field property if you want to remove/delete the field.
You can customize the form properties such as Font, Font Size (max up to 15), Font Color, Background Colour, Label Alignment, and Form Width (450-800).
You can customize the properties of the buttons used in the webform according to your preferences.
You need to provide the following details to create a webform:
- Form Location URL: This is the website URL where you intend to embed your webform. After entering the URL, click Add. You can remove any location URL that you have added by hovering over it and clicking the Remove [
] icon. Use * if you do not want to add specific URLs.
- Landing page URL: This is the page URL where you want to redirect the user after the form is submitted.
- Assign Owner: The Super Admin will be automatically assigned as the owner of the record created via the webform.
- Customer Mapping: This is to determine if you want to use an existing customer or new customer in the record created via the webform. Refer to this section for more details.

Customer Mapping
Choose whether you want the customer details that you provide in the webform to be used for creating Contact, Company, or Contact & Company records. Based on the choice made for Customer Mapping, you will have to select how the Contact Mapping and/or the Company Mapping should be done.
In the Contact Mapping and Company Mapping fields, you can choose whether the customer details entered in the webform should be used for creating new customer (company/contact) records or mapped to existing customer (company/contact) records.
The following choices are available:
Scenario 1 Always create a new contact for every webform submission
Scenario 2 Map the customer details provided in the webform to an existing contact based on the phone number and/or email address.
You can use any of the following options to choose an existing customer
- Phone Number: If the phone number provided matches that of an existing contact, then that contact will be used.
- Email Address: If the email address provided matches that of an existing contact, then that contact will be used.
- Any (Phone No or Mail ID): If the phone number or email address provided matches that of an existing contact, then that contact will be used.
- Both (Phone No and Mail ID): If the phone number and email address provided matches that of an existing contact, then that contact will be used.
Choose a value for Duplicate Handling to determine the record to be used in case of more than one match.
Map company when the existing contact is linked to one checkbox
Select this checkbox if you want to use the company already linked to the existing contact.
When the checkbox is selected:
- If the contact has a company → that existing company will be used.
- If the contact has no company, but a company is provided in the webform → a new company will be created from the webform details, along with a new contact linked to it.
When the checkbox is NOT selected, and the contact already has a company:
- If a company is entered in the webform → a new company will be created from the webform details, and a new contact will be created and linked to it. (The existing company on the contact is ignored.)
- If no company is entered in the webform → only the contact details will be used.
Scenario 3 Always create a new company for every webform submission
Scenario 4 Map the customer details provided in the webform to an existing company based on the company name.
Choose a value for Duplicate Handling to determine the record to be used in case of more than one match.
Company matches, and contact details are provided in the webform
If the company in the webform matches an existing company record, and new contact details are entered in the webform, a new contact is created using the webform details and linked to the existing company.
Company matches, and the contact also already exists under that company
If the company matches an existing record, and the contact details in the webform match a contact already associated with that company (for example, the same email address), the submission will result in an error. This is because a contact with the same email address already exists under the company, and duplicates are not allowed.
Company does not match
If the company details in the webform do not match any existing company, the system will:
- Create a new company using the details from the webform.
- Create a new contact using the details from the webform.
- Link the new contact to the newly created company.
Scenario 5 Always create a new company and contact for every webform submission
Scenario 6 Map the customer details provided in the webform to an existing company based on the company name. Create a new contact and map it to the existing company.
Scenario 7 Map the customer details provided in the webform to an existing company based on the company name. Also, map the customer details provided in the webform to an existing contact based on the phone number and/or email address. The contact will be mapped to the company.
You can use any of the following options to choose an existing customer
- Phone Number: If the phone number provided matches that of an existing contact, then that contact will be used.
- Email Address: If the email address provided matches that of an existing contact, then that contact will be used.
- Any (Phone No or Mail ID): If the phone number or email address provided matches that of an existing contact, then that contact will be used.
- Both (Phone No and Mail ID): If the phone number and email address provided matches that of an existing contact, then that contact will be used.
Choose a value for Duplicate Handling to determine the record to be used in case of more than one match.
The below two options will also be available:
- Map company when the existing contact is linked to one: If the selected criteria matches a contact that is already associated with a company, that company will be assigned to the created record, even if the company criteria is not matched.
- Create contact under the matched company: If no matching contact is found but the company criteria matches, a new contact will be created under the matching company.
Points to remember
- If you have enabled multi-currency in your organization, then the currency used in the record created via webform will be based on the following conditions:
- The base currency will be used if a new contact is created.
- For existing contacts, their currency will be used.
- If a record is created via a webform, it will be indicated so in its timeline.
- If you do not provide values for Phone Number/Mail ID or provide values that doesn't find a match, then a new record will be created.
- If different matching records are found for the Phone Number/Mail ID values provided, then a new record will be created. E.g. if the condition chosen is Any (Phone No or Mail ID) and the Phone No matches one customer record and the Mail ID matches another customer, then a new customer record will be created.
Example
This example describes how you can add a webform to your website through which your customers can submit a request to Zoho FSM. The website is created using Zoho Sites.
- Log in to Zoho Sites.
- Click Create New Website.
- Enter a website name, pick your website's category, and click Choose Theme.

- Choose a template you want to use and click Customize.

- Choose the Color, Font, Header, and Banner of your liking and click Finish.

- Click the area in the website where you want to place the request form and click Add Element.

- Select Code Snippet from Elements > Others.

- In the Code Snippet dialog, paste the source code of the webform and click Ok.

The webform will be embedded in your website.
- Save the changes and click Publish.

- Provide your domain details and click Publish.
You can either choose a free subdomain of zohosites.com, or use a domain you already own. - Access your website.
- Enter the details in the form and click Submit.

A new request is created in Zoho FSM.

From the
Webforms Details page, hover over a webform entry to find the
Edit,
Get Code, and
Delete options. I
f you make any formatting changes in the webform, you need to update the existing forms which uses this webform with the newly created source code. Toggle the Status switch to the left to deactivate a webform. Once a webform is deactivated, then any subsequent submissions made through this webform will not create any records in Zoho FSM.
