Articles in this section
Authenticate Emails with SPF, DKIM, and SenderID Auto forward your emails to Vtiger Automate Outgoing Emails in Email Settings Managing User Profiles Automation - Approvals Automation - Assignment Rules Set up Multi-path Workflows Creating a Scheduled Workflow Automation - Workflow Scheduler Workflows in Vtiger CRM Webforms in Vtiger CRM Set up a Workflow Action to Create Event Set up a Workflow Action to Create Records Set up a Workflow Action to Create Task Set up a Workflow Action to Invoke Custom Function Set up a Workflow Action to Create an SMS Task Set up a Workflow Action to Send Mails Workflow Action to Update Fields Automation - Webhook Workflow Automation - Expressions Workflow Configuration - Business Hours Configuration - Company Details Configuration - Consents Configuration - Customer Portal Maps in Vtiger CRM Configuration - Usage Details Configuring Encrypted Data Fields in Vtiger CRM Configure Picklist Dependencies Considerations for Deactivating Vtiger Users Control Fields and Record Displays using Configuration Editor Create Reminders for Records and Inbox Create a field of a Grid type Dealing with Currencies and Taxes Enable Desktop Notifications on Chrome Web Browsers Vtiger CRM Add-ons IMAP Configuration - 2-way sync between Vtiger and IMAP providers Setting up Autopay & Payment Gateways Inventory - Tax Management Inventory - Terms and Conditions Login to Vtiger on SSO SAML using ADFS Mailroom Functionality for Different Scenarios Manage Multiple Currencies Marketing and Sales - Deal to Project Mapping Lead Conversion Data Mapping Marketing and Sales - Profile Scoring Module Management - Labels Editor Module Management - Module Numbering Configure My Preferences Feature My Preferences - Calendar Settings Tags in Vtiger My Preferences - Notification Preferences SAML Support in Vtiger CRM Vtiger Mailroom Settings - Configure Module Settings Settings - Create Dynamic Fields and Layouts Module Management - Creating a Relationship Between Modules Settings - Customize Records and Fields for your Business Settings - How to set email autoresponder to Webform submission? Settings - Left Menu Settings - Manage Global Picklists in Vtiger Settings - Set up your Support Team Settings - Start Up Page Settings - Working with Picklist Values Support - SLA Policies Troubleshooting Login Issues Add-Edit Unsubscribe Links in your Email Template User Management - Authentication User Management - Encrypted Field Access Logs User Management - Groups User Management - Login History User Management - Profiles User Management - Roles User Management - Settings Log User Management - Sharing Rules User Management - Users User Management - Vtiger Support Access Vtiger Buzz - Chrome Extension for Notifications Vtiger Implementation wizard Vtiger Language Support Configuring Websense Trackers Websense - Widgets Module Management - Module Layouts & Fields Auto forward Emails from Microsoft Office 365 Automation - SMS Reply Actions Duplicate Record Prevention in Vtiger CRM Module Management - Modules Generate and Manage Third-party App Passwords in Yahoo Configuring App Passwords for Gmail Outgoing Server and Yahoo Mail Configuration - Storage Guard Customizing your Self-Service Portal Theme Using CSS Styles Adding Hidden Fields to a Webform Configuring Dependent Fields and Blocks for Modules Adding Custom Module Login Page Customization Settings - Personalize Module Layouts Formula Fields Creating Custom Filters Adding a local DNS Entry

Module Management - Module Builder

Create custom modules, add custom blocks and fields, and create relationships with other modules using Vtiger's Module Builder.
R
Ruba
24 Oct, 2025 - Updated  3 days ago

Feature Availability

Vtiger Editions: One Pilot | One Growth One Professional | One Enterprise | One AI

Introduction

Every business is unique, and so are its data needs. In Vtiger CRM, you can create custom modules to capture and organize the information that matters most to your business.

A module in Vtiger is a collection of records that store related information. For example, the Leads module holds details about potential customers, while the Contacts module contains information about existing customers. Similarly, with Custom Modules, you can define and manage your own data structures.

Suppose your company is managing a new project that requires a specialized workforce. You can create a Workforce module within the Projects app to track team members, their roles, and assignments.
Custom Modules enable you to tailor your CRM to match your business model, eliminating the need for predefined templates.

Key Features

  • Flexible Module Builder: Create new modules directly from the CRM's Module Management settings.
  • Custom Blocks and Fields: Define the structure of your module by adding new blocks and custom fields.
  • Custom Relationships: Establish relationships between your custom module and existing CRM modules.
  • Customizable List Views: Choose which fields appear in the module's List View by default.
  • Full Admin Control: Only CRM Admin users can create, modify, or delete custom modules.

Benefits

The benefits of Module Builder are:

  • Personalized Data Management: Capture and organize data specific to your business processes.
  • Improved Productivity: Access all relevant data in one place, reducing time spent switching between tools.
  • Enhanced Reporting: Create reports that include custom module data for better visibility and insights.
  • Seamless Integration: Link custom modules with standard modules, such as Projects, Contacts, or Deals.
  • Scalable Design: Modify or delete modules as your business processes evolve.

Key Terminology

Key Term

Definition

Module

A set of records that store a specific type of information (For example, Leads, Contacts, Projects).

Custom Module

A user-defined module created to meet specific business needs.

Block

A section within a module that groups related fields.

Field

A data entry element (For example, Name, Phone Number, Email).

Module Builder

A tool in Vtiger CRM used to create and configure custom modules.

Record Identifier

The primary label used to identify records in a module.

Relationship

A link established between two modules to associate related records.

 

In this article, you will learn about:

  • Modules in Vtiger.
  • Creating a custom module.
    • Defining module properties.
    • Managing blocks and fields.
    • Setting up a relationship between modules.
  • Deleting a module.

Creating a Module

Creating a module involves the steps below:

  • Accessing the Module Management settings.
  • Creating a custom module.
    • Specifying the module properties.
    • Creating blocks and fields.
    • Choosing columns for your default lists.
    • Creating relationships with other modules.

We'll look at all these steps in detail, but before that, let's look at an example of a module.

Consider that your company has acquired a new project and needs to assign a specialized workforce to it. You can create a module called Workforce under the Projects app. The workforce will contain records of all the team members working on the new project.
Note: You can create custom modules only if you are an Admin user.


Follow these steps to create a module:

Step 1: Access the Module Builder

Follow the steps below to access the Module Builder:
 

  1. Log in to the CRM.
  2. Go to the Main Menu.
  3. Click Settings.
  4. Look for the Module Management tab.
  5. Select Module Builder.

Step 2: Creating a custom module

Follow the steps below to create a custom module:
 

  1. Log in to the CRM.
  2. Go to the Main Menu.
  3. Click Settings.
  4. Select Modules under the Module Management tab.
  5. Click + Create Module.

Step 3: Specify the Module Properties

Once you click Create Module, you must specify its basic details.

Follow the steps below to enter module properties:
 

  1. Enter the following information:
    1. Module Label: Specify the module name. For example, Workforce.
    2. Singular Module Label: Specify the module name in the singular form. For example, if the module name is Contacts, then Contact is its singular form. The singular form of Workforce is Workforce.
    3. Select App Category: Select the app under which you want to create the module. For instance, you will create Workforce under Projects.
    4. Record Identifier: Specify the label by which you want to identify the module's records. For example, Workforce Records are identified by Workforce Name.
  2. Click Create.

Step 4: Create Blocks and Fields

Note: Some fields in the Basic Information block are pre-populated by default.

You can also create custom fields and blocks if needed.

Follow the steps below to create a custom block:
 

  1. Click +Add Custom Field under any block you want to create it in. For example, under Basic Information, Address Details, and so on. 
  2. You can also create a new block and a custom field under it:
    1. Click +Add Block.
    2. Enter the block name.
    3. Choose the existing block after which you want to add the new block. 
    4. Click Save.
    5. Click +Add Custom Field in the newly created block.
  3. Select the field type. For example, Phone for a phone number, Text for a name, etc.
  4. Enter the field name under Label Name.
  5. Enter a default value for the field (optional).
  6. Set the field properties:
    1. Mandatory Field: If enabled, entering a value for the field becomes mandatory.
    2. +Quick Create: If enabled, the field becomes available under Quick Create
    3. Key Field View: If enabled, the field appears in the Key Fields section of a contact's Summary View.
    4. Header View: If enabled, the field appears in the Header section of a contact's Summary View.
    5. Mass Edit: If enabled, you can perform a mass edit action on the field.
    6. Click Save.
  7. Click Next.

Step 5: Choose the Default Filter

In this step, you must choose the columns that will appear by default in the List View of the module.
 

Follow the steps below to choose the default filter:

  1. Click on the space provided under Choose columns and order (Max 16).
  2. Select fields from the list to add to the List View.
  3. Click Next.

Step 6: Build a relationship between the custom module and other modules 

To create a link between records in different modules, you need to build a relationship between the modules.
 


Follow the steps below to set up relationships:

  1. Click +Add Relationship(on the left, under the tabs).
  2. Choose the module with which you want to create a relationship from the Select related module drop-down.
    1. If you consider the example above, you must select 'Projects' from the drop-down. Projects become the related module.
  3. Pick a relationship type under Select relationship type.
  4.  Specify the names of the related and custom module fields/tabs that must appear in the modules' records. (You will get more clarity on this in the next section.)
  5. Click Save.

We have detailed information on the need to create relationships between modules, different types of relationships, and the procedure to follow. To learn about it, click here.

Deleting a Module

Follow these steps to delete a custom module:

  1. Log in to the CRM.
  2. Go to the Main Menu.
  3. Click Settings.
  4. Select Modules under the Module Management tab.
  5. Look for the desired custom module.
  6. Hover over the module name and click More.
  7. Click Delete.
  8. Click Yes to confirm.
 

Note:

  • You can delete only custom modules. Deleting a custom module does not affect the existing modules.
  • You can delete a module only if you are an Admin user.
      Related articles
      User Management - Profiles Module Management - Modules Integrating your Facebook Account with Vtiger Social
      Home Privacy Policy Terms of Service Security Center Policy & Legal Center Contact Us
      © Copyright 2025 Vtiger. All rights reserved.
      Powered by Vtiger
      Facebook Twitter Linkedin Youtube