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 review

How 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.

ItemWhat Zoho documentsWhat it means for you
Location URLs per formStandard and Professional 5; Enterprise 10; Ultimate 20; Developer 5Applies 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 CaptchaPaid editions onlyIf you are not on a paid edition, plan spam protection on the website side instead.
Google reCAPTCHA v2All paid editions; one per formA common choice for a public enquiry form.
File upload fieldPaid editions; 20 MB combined per submissionFine for a CV or a short brief. Not for drawings or large site photos.
QR code publishingEnterprise and aboveRelevant for printed material or event stands; most sites will not need it.
Unsupported field typesLookup, Auto Number, FormulaThese 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.

  1. 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.
  2. Decide the module. Leads for new enquiries; Contacts only if you are capturing from known customers; Cases for support requests.
  3. 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.
  4. Set the form details. Form name, Location URL, assignment (a named user, or an assignment rule such as round-robin) and notification.
  5. 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.
  6. Set the post-submission action. A thank-you page, redirect URL or splash message. The URL cannot exceed 255 characters.
  7. 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.

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.

SymptomPossible causesCheck that distinguishes them
Form submits, no record anywhereLocation URL does not match the hosting domain; form deactivated; hidden fields removed; page on HTTPCompare 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 tabManual approval enabled in the Lead Assignment sectionEdit the form and look at the approval checkbox; check the approval queue
Record exists but the right person cannot see itViewing permissions; assignment rule routing to another ownerOpen the record as admin and check owner; check the profile's access to that module
Odd characters in names or messagesThe website editor or a third-party tool converting special charactersPaste the code into a plain Custom HTML block; test with a name containing an accent
Legitimate enquiries missingRecords held as potential spam; approval pendingCheck the spam review queue and the threshold set on the form
"Undefined" error when saving the formLanding URL longer than 255 characters, which Zoho's FAQ gives as the cause of that errorShorten 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 audit

Other 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
Dirk van Greuning — Founder, Growth Pulse Media
Dirk van Greuning Founder, Growth Pulse Media

Founder of Growth Pulse Media and a specialist in South African search dominance. Dirk translates his experience in scaling South African businesses into high-velocity digital strategies for B2B and retail leaders. He writes about SEO, lead generation, and paid media from an operator's perspective — prioritising pipeline value over impressions.

Connect on LinkedIn