Zoho CRM webforms are website forms that write each submission straight into a Zoho CRM module as a record, with an owner, a notification and a lead source attached. For a South African business choosing among the tools in the CRM software options for South Africa, they are a direct way to stop re-typing website enquiries, provided the form is built in the right order and the consent field is designed from the start.
Zoho's own documentation covers the click-path well. What it does not tell you is which limits bite first, why a form can submit without a single record appearing, or how to handle POPIA consent at the form. This guide covers those three things, using the figures in Zoho's Setting up Webforms help article as it read in October 2026.
Quick Answer
Zoho CRM webforms are built under Setup > Channels > Webforms, in a chosen module such as Leads, Contacts or Cases, and published as source code, embed code, an iFrame, a link or a QR code. Create your custom fields (consent checkbox, lead source) before you build the form, then keep the system-generated hidden fields intact and match the Location URL to the page that hosts the form. Zoho's own troubleshooting list names the last two among the common causes of forms that capture nothing.
Enquiries going in but not showing up?
Send us the page your form sits on and we will review the page, the traffic reaching it and the tracking around it.
Get a form flow reviewHow Zoho CRM Webforms Work
A Zoho CRM webform is a form you design inside the CRM, whose HTML or embed code you paste into your own site, so that a visitor's submission creates a record without anyone typing it in. Zoho documents support for Leads, Contacts, Cases, Vendors, custom organisation modules and team modules (Zoho CRM webforms introduction).
The person building the form needs the Manage Webform permission, according to Zoho's introduction. If a colleague cannot find the feature, ask whoever administers the account to check their permissions before assuming it is missing from your plan.
This differs from a form plugin that emails you. The submission lands in the CRM, is assigned by your rules, and can trigger a notification and an auto-response. That is the reason to use it. It is also why a badly planned form creates a CRM problem rather than just an inbox problem, which is the subject of the CRM implementation checklist.
Takeaway: what the form replaces
A web form replaces the step where someone copies an enquiry from an email into the CRM. It does not replace lead qualification. Decide who owns a new lead and how fast they must respond before you publish, because the form will create records the moment it goes live.
Which Limits Apply by Edition?
Zoho CRM web forms are limited by edition in the number of website addresses a form may be published from, and some features, such as CAPTCHA, file uploads and QR codes, depend on edition too. The Location URL limit is the one most likely to catch agencies and multi-site businesses.
| Item | What Zoho documents | What it means for you |
|---|---|---|
| Location URLs per form | Standard and Professional 5; Enterprise 10; Ultimate 20; Developer 5 | Applies on every edition. A business running several brands or landing pages on separate domains may hit the cap. Zoho says entering * accepts submissions from any domain. |
| Standard Captcha | Paid editions only | If you are not on a paid edition, plan spam protection on the website side instead. |
| Google reCAPTCHA v2 | All paid editions; one per form | A common choice for a public enquiry form. |
| File upload field | Paid editions; 20 MB combined per submission | Fine for a CV or a short brief. Not for drawings or large site photos. |
| QR code publishing | Enterprise and above | Relevant for printed material or event stands; most sites will not need it. |
| Unsupported field types | Lookup, Auto Number, Formula | These cannot go on the form. As a working suggestion of ours, collect the value another way, for example with a pick list. |
The number of active forms per module also depends on edition, according to Zoho's webform FAQ. If you plan one form per service line, check your edition's quantity before designing the set.
The Build Order That Avoids Rework
The build order for a Zoho CRM webform setup matters because a field must exist in the module before it can be dragged onto the form, so the fields come before the form itself. As a precaution of ours, check after any later edit whether the code on your site needs replacing. Build in this sequence.
- Create custom fields first. Under Setup > Customization > Modules and Fields, add the consent checkbox, a Lead Source value if you need it, and any pick lists. Lookup, Auto Number and Formula fields will not work on a webform.
- Decide the module. Leads for new enquiries; Contacts only if you are capturing from known customers; Cases for support requests.
- Build the form. Setup > Channels > Webforms > New Form. LastName, Email and Phone are default mandatory fields for Leads and Contacts and cannot be removed, so plan the layout around them.
- Set the form details. Form name, Location URL, assignment (a named user, or an assignment rule such as round-robin) and notification.
- Choose spam protection. reCAPTCHA v2, plus the spam threshold: Zoho holds records for manual review once the spam possibility score reaches a default of 90%-100%, adjustable per form.
- Set the post-submission action. A thank-you page, redirect URL or splash message. The URL cannot exceed 255 characters.
- Copy the code and test on the live page before you send traffic to it.
Double opt-in changes the flow
If you turn on double opt-in, the record only enters the CRM after the visitor confirms by email. Zoho requires the primary email field on the form, and double opt-in cannot be combined with the splash message. Choose a redirect or thank-you page instead.
Embedding the Form on WordPress and Other Sites
Embedding a Zoho CRM webform on WordPress means pasting the generated code into the page, and it only works if the system-generated hidden fields and the Location URL survive the paste. Zoho offers source code, embed code, iFrame, direct link and QR code, and its FAQ describes choosing the Embed, Source or iFrame format on the WordPress tab and pasting the code into the HTML editor.
Four things to check on a Zoho CRM webform WordPress embed:
- Paste into a Custom HTML block, not a paragraph block. This is our own suggestion: Zoho lists third-party character conversion as a known cause of failed submissions, and a plain HTML block gives an editor less chance to alter the code.
- Leave the hidden fields alone. Zoho names xnQsjsdp, xmIwtLD and actionType as the system-generated fields that must stay in the form.
- Serve the page over HTTPS. Zoho's troubleshooting list says to use HTTPS, not HTTP. If your site throws browser warnings, fix them first; our WordPress mixed content guide covers it.
- If you use the iFrame, add the extra script Zoho provides to the head of the page so analytics stay accurate.
Spam is the other reality for any public form. Zoho's reCAPTCHA and spam threshold sit on the CRM side; the website side has its own options, covered in WordPress form spam prevention. Use both rather than relying on one.
Takeaway: what to match before launch
If the domain hosting a form does not match its Location URL, Zoho's FAQ says no information is captured. Zoho's troubleshooting list also names removed hidden fields, HTTP pages, inactive forms, pending approvals and viewing permissions as common reasons submissions go missing. Check the domain match first.
Tracking Lead Source With Hidden Fields
A hidden Lead Source field tells the CRM which page or form produced a lead without asking the visitor anything, and it is the simplest way to see which pages feed your pipeline. Zoho's FAQ describes adding a hidden field such as Lead Source to each form with its own default value (for example Website or Blog).
Set the default value to something specific enough to act on: a service page name, a campaign name, a landing page. Then report on Lead Source inside the CRM. If paid traffic is arriving, pair the CRM view with your analytics, as set out in tracking lead forms in South Africa, so you are comparing the same submissions on both sides.
Name the values consistently from the first form. A convention set up on form one saves a cleanup on form eight, which is the point of the CRM field naming convention.
Building a POPIA-Aware Lead Capture Form
A Zoho CRM lead capture form that feeds marketing emails needs a recorded consent decision at the point of capture, because section 69 of POPIA covers direct marketing by electronic communication and, subject to certain exceptions, that requires consent. DLA Piper's summary of the Information Regulator's Guidance Note on Direct Marketing states that such marketing "generally requires consent subject to certain exceptions" (DLA Piper). Replying to a quote request is a separate matter from sending marketing.
Zoho supports recording the decision with an opt-in checkbox: create a checkbox field in the module, add it to the form, and the answer is stored on the record. You can edit the label text in the form's HTML, but the field's name value must not change or the answer will not reach the CRM.
Three working points follow from the law and the tool:
- Separate the enquiry from the marketing consent. A person asking for a quote has not necessarily agreed to a newsletter. As a practitioner recommendation, use a separate, clearly worded checkbox for marketing and leave it for the visitor to tick.
- Name the sender and provide a way out. According to the same summary, electronic marketing messages must carry the sender's identity and an address to which the recipient can send a request that such messages cease. Build both into your marketing templates.
- Do not assume business addresses are exempt. The summary we reviewed does not address whether business email addresses are treated differently, so do not build a flow on a B2B exemption.
Section 69(3) of POPIA makes a separate provision for existing customers; read its conditions in the Act before relying on it, because a first-time web enquirer is not an existing customer. This is a practical summary, not legal advice; the detail is in POPIA email compliance, and Zoho's own data handling is part of the CRM security and POPIA picture.
Why Is a Form Submitting but Not Creating Records?
A form that submits without creating a visible record has several possible causes, and Zoho's FAQ lists most of them. The table maps each symptom to the possible causes and the check that tells them apart; the checks are our suggested way of testing Zoho's listed causes.
| Symptom | Possible causes | Check that distinguishes them |
|---|---|---|
| Form submits, no record anywhere | Location URL does not match the hosting domain; form deactivated; hidden fields removed; page on HTTP | Compare the Location URL with the address bar; check the Status icon under Webforms; compare the pasted code against the generated code |
| Record exists but is not under the Leads tab | Manual approval enabled in the Lead Assignment section | Edit the form and look at the approval checkbox; check the approval queue |
| Record exists but the right person cannot see it | Viewing permissions; assignment rule routing to another owner | Open the record as admin and check owner; check the profile's access to that module |
| Odd characters in names or messages | The website editor or a third-party tool converting special characters | Paste the code into a plain Custom HTML block; test with a name containing an accent |
| Legitimate enquiries missing | Records held as potential spam; approval pending | Check the spam review queue and the threshold set on the form |
| "Undefined" error when saving the form | Landing URL longer than 255 characters, which Zoho's FAQ gives as the cause of that error | Shorten the URL, removing long tracking parameters |
Change one thing at a time and re-test after each change, so you know which fix worked.
A sensible test routine before launch
Submit the live form from a phone on mobile data, not only from your office Wi-Fi. Use an email address you control, confirm the record, owner, lead source and notification, then submit once more with the consent box unticked and confirm that the field stores the difference. That second test only proves anything if the checkbox is mapped to a field on the record. Decisions and checks only: no result is claimed here.
Want the full lead path audited?
We will review the page, the tracking and the traffic feeding your enquiry form as one flow and send you what we find, with no obligation.
Book a lead flow auditOther Lead Sources Outside the Website Form
A web form captures only enquiries submitted on your own site; native Meta and LinkedIn forms create leads outside it and need their own integration. If you run these alongside Zoho, treat each as a separate source with its own Lead Source value. Our guides on Meta lead ads CRM integration and LinkedIn lead gen forms and CRM integration cover what happens after the click. If you are still choosing between tools, Zoho CRM vs Bigin and HubSpot vs Zoho compare them, and Pipedrive web forms covers the equivalent feature there.
Why South African Businesses Choose Growth Pulse Media
Growth Pulse Media is a Johannesburg-based agency founded by Dirk van Greuning, who built and scaled a large South African ecommerce business before starting the agency. All work is executed in-house, with a limited client load so that senior attention stays on your account. We work with Google Ads, Meta Ads, GA4 and Search Console, which means we focus on what happens before the form: the traffic, the landing page and the measurement.
A well-built CRM form still needs the right visitors and a clear next step. Our digital strategy service is where we map that path, from the first click to the owner who calls back. We do not claim hands-on Zoho CRM configuration as a service.
Who This Is Not For
You want a one-click plugin
Zoho webforms need field planning, assignment rules and testing. If you want a form that "just works" with no CRM decisions, a basic contact form is a better fit.
You have not checked what your edition includes
Standard Captcha and file uploads are paid-edition features, and QR code publishing starts at Enterprise. Location URL limits apply on every edition. Check your plan before you design around a feature.
You want legal sign-off on consent wording
This guide explains how the tool and POPIA fit together. It is not legal advice. Have your attorney approve the final wording and privacy notice.
Frequently Asked Questions
What are Zoho CRM webforms used for?
Zoho CRM webforms capture visitor information from a website and create records in Leads, Contacts, Cases and other supported modules. Records can be assigned to an owner automatically and trigger a notification or auto-response.
How many Zoho CRM webforms can I publish on different websites?
The number of Location URLs allowed depends on your edition: 5 on Standard and Professional, 10 on Enterprise, 20 on Ultimate and 5 on Developer, according to Zoho's setup article. Entering * accepts submissions from any domain.
Why is my Zoho CRM webform not working on my website?
Common causes in Zoho's own troubleshooting list are a Location URL that does not match the domain, removed hidden fields, an HTTP page, an inactive form, pending approvals and permissions. Check them one at a time using the table above.
Can I add a consent checkbox to a Zoho CRM webform?
Yes. Create a checkbox field in the module, add it to the webform, then generate and copy the code to publish. You can edit the label text, but you must not change the field's name value, or the answer will not be passed to the CRM.
Can I track which page a lead came from?
Yes. Add a hidden field such as Lead Source to each form with its own default value. When the form is submitted the value is stored on the record without the visitor seeing it.
Get your Zoho CRM webform capturing leads properly
Send us the page your form sits on and the traffic sources feeding it. We will look at the page, your Google Ads and Meta Ads traffic and the GA4 tracking around it, and tell you what to fix first. No obligation, we will get back to you within 24 hours.
Talk to us

