Creating a custom module in Zoho CRM lets you extend the platform beyond its default objects — Leads, Contacts, Deals — to capture any business-specific data your team needs.
Why this matters
Most businesses have data that doesn't fit neatly into Zoho CRM's standard modules. Custom modules let you model unique entities — vehicles, properties, projects, equipment — and connect them to existing records via lookup fields. Once a module exists, you can build reports, queries, and automations on top of it, giving your team a single source of truth inside CRM. [4][5]
Step-by-step
Step 1. Log in to Zoho CRM and navigate to Setup. From the Setup menu, locate the Customization section and select Modules and Fields. This is the central hub for managing all module-level configuration in your account. [5]
Step 2. On the Modules and Fields page, click New Module (or the equivalent "Create Module" button depending on your edition). Give the module a meaningful name — for example, "Vehicles" for a car rental business — and assign it a plural label that will appear in the navigation bar. The system will auto-generate an API name based on the label you enter. [4]
Step 3. Once the module shell is created, you'll land in the Layout Editor. Here you can drag and drop field types onto the layout canvas to define what information the module will store. Standard field types include single-line text, number, date, picklist, and lookup. Arrange fields into sections to keep the layout readable for your team. [4][5]
Step 4. To connect your new module to an existing one — for example, linking a "Vehicles" record to a "Contacts" record — add a Lookup field. A lookup field establishes a relationship between two modules, so that from a vehicle record you can immediately see the associated customer, and vice versa. [4]
Step 5. Save the layout. Your new module will now appear in the CRM navigation and will be accessible to users based on their profile permissions. You may need to visit Roles and Profiles under Setup to grant the appropriate access levels to each user group. [5]
Step 6. (Optional) Once the module is live, you can build Queries against it via Setup → Developer Hub → Queries. Click Add Query, enter a Query Name and API Name, then select your new module as the source under Configuration. You can include up to two related (lookup) modules and select up to 50 fields per query. Under Criteria, choose whether to return all records or filter by field values — including dynamic values that are resolved at runtime. [1]
Common pitfalls
- Edition restrictions. Custom modules are available on higher-tier plans. For example, in Zoho Desk the equivalent feature requires the Enterprise edition, and similar tier requirements apply in Zoho CRM. Verify your plan supports the number of custom modules you need before building. [4]
- Lookup field limits in queries. When writing a query against a module, you can reference a maximum of two related (lookup) modules in the Related Module drop-down, and a maximum of 50 fields total. Trying to exceed these limits will prevent the query from saving. [1]
- API name conflicts. The auto-generated API name must be unique across your org. If you create two modules with similar display names, CRM may append a suffix — double-check the API name before building integrations or functions that reference it by name. [1]
- Mobile visibility. Fields and related lists configured on the web layout may not automatically surface in the Zoho CRM mobile app. After creating your module, test the mobile view and adjust which fields appear for mobile users separately. [6]
What to check
- Permissions are set correctly — confirm that the relevant user profiles have read/write access to the new module under Setup → Roles and Profiles, otherwise team members won't see it in their navigation. [5]
- Lookup relationships resolve as expected — open a test record in your new module and verify that the lookup field correctly pulls through data from the linked module (e.g., Contacts or Accounts). [4]
- Queries return the right data — if you created a Developer Hub query against the module, run it with sample criteria to confirm the field selection and any dynamic values behave as intended before wiring it into automations. [1]
---
*Beam Help is an independent expert support resource for Zoho products and is not official Zoho support. For licensing or account-level questions, contact Zoho directly.*