- Permission Required: Webforms

- Find out the Edition-specific limits for Webforms.

Create a Webform 

1. Go to Setup > Developer Space > Webforms and click Create Webform.
   
   
   
   
2. Enter the following details, then click Add Form:
   
1. A Name for the webform
   
2. A Description for the webform
   
3. The Module for which you want to create the webform.
   Webforms are currently only supported in the Requests module.
   
   
   
   
3. Add the necessary Form Details and click Next.
   
4. Provide the required information in the Webform Details page and click Save.
   
5. Click Get Code.
   
   
   
   
6. 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.
   
    

Add Form Details 

1. 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.
   
   
   
   
2. 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.

1.  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.
   
   
2. 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.

Form Properties

Button Properties

Webform Details 

1. 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.
   
2. Landing page URL: This is the page URL where you want to redirect the user after the form is submitted.
   
3. Assign Owner: The Super Admin will be automatically assigned as the owner of the record created via the webform.
   
4. 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 

1. Map to existing Customer by
   
2. Always create new

1. Phone Number: If the phone number provided matches that of an existing customer, then that customer will be used.
   
2. Mail ID: If the email address provided matches that of an existing customer, then that customer will be used.
   
3. Any (Phone No or Mail ID): If the phone number or email address provided matches that of an existing customer, then that customer will be used.
   
4. Both (Phone No and Mail ID): If the phone number and email address provided matches that of an existing customer, then that customer will be used.

1. Note that only if a single exact match is found in Zoho FSM, will that existing record be used, else a new record will be created.
   
2. 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.
   
3. If more than one matching record is 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.
   
4. If the Phone/Mail ID provided has a match but the Customer Name does not match, then the existing Customer Name will be used.
   
5. In Type II, III, and IV, if the values provided by you match an existing contact but not its associated company, then a new contact will be created. The company name provided will be added as the associated company. Similarly, in Type I, if the values provided by you match an existing company but not its associated contact, then a new company will be created. The contact name provided will be added as the associated contact.
   

1. 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:
   
1. The base currency will be used if a new contact is created.
   
2. For existing contacts, their currency will be used.
   
2. If a record is created via a timeline, it will be indicated so in its timeline.
   

Example  

1. Log in to Zoho Sites.
   
2. Click Create New Website.
   
3. Enter a website name, pick your website's category, and click Choose Theme.
   
   
   
   
4. Choose a template you want to use and click Customize.
   
   
   
   
5. Choose the Color, Font, Header, and Banner of your liking and click Finish.
   
   
   
   
6. Click the area in the website where you want to place the request form and click Add Element.
   
   
   
   
7. Select Code Snippet from Elements > Others.
   
   
   
   
8. In the Code Snippet dialog, paste the source code of the webform and click Ok.
   
   
   
   The webform will be embedded in your website.
   
   
9. Save the changes and click Publish.
   
   
   
   
10. Provide your domain details and click Publish.
    You can either choose a free subdomain of zohosites.com, or use a domain you already own.
11. Access your website.
    
12. Enter the details in the form and click Submit.
    
    
    
    A new request is created in Zoho FSM.
    
    
    

Manage Webforms