Articles in this section
Authenticate Emails with SPF and DKIM Auto-forwarding your emails to Vtiger Automate Outgoing Emails in Email Settings Automation - Approvals Automation - Assignment Rules Automation - Multi-path Workflows Automation - Scheduled Workflows Automation - Scheduler Automation - Standard Workflows Automation - Webforms Automation - Workflow Action - Create Event Automation - Workflow Action - Create Records Automation - Workflow Action - Create Task Automation - Workflow Action - Invoke Custom Function Automation - Workflow Action - SMS Task Automation - Workflow Action - Send Mail Automation - Workflow Action - Update Fields Automation - Workflow Action - Webhook Automation - Workflows - Vtiger Expressions Configuration - Business Hours Configuration - Company Details Configuration - Consents Configuration - Customer Portal Configuration - Maps Configuration - Usage Details Configure 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 Customize your self-service portal theme using CSS styles Dealing with Currencies and Taxes Enable Desktop Notifications on Chrome Web Browsers Extensions - Extension Store IMAP Configuration - 2-way sync between Vtiger and IMAP providers Inventory - Payments and Subscriptions Inventory - Tax Management Inventory - Terms and Conditions Login to Vtiger on SSO SAML using ADFS Mailroom Functionality in Different Scenarios Manage Global Picklists Manage Multiple Currencies Marketing & Sales - Forecast and Quota Settings Marketing & Sales - Pipelines and Stages Marketing and Sales - Deal to Project Mapping Marketing and Sales - Lead Conversion Data Mapping Marketing and Sales - Profile Scoring Module Management - Labels Editor Module Management - Module Numbering My Preferences My Preferences - Calendar Settings My Preferences - My Tags My Preferences - Notification Preferences SAML Support in Vtiger CRM Set up 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 Unsubscribe your Email 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 Websense - Trackers Websense - Widgets Working with Picklist field values Configuring Dependent Fields and Blocks for Modules Duplicate Prevention in Modules Module Management - Modules Module Management - Module Layouts & Fields Configuration - Storage Guard

Module Management - Module Builder

Create custom modules, add custom blocks and fields, and create relationships with other modules using Vtiger's Module Builder.
Sabqat Ruba
9 Mar, 2021 - Updated 1 month ago


Did you know you can create custom modules in Vtiger CRM? 

Yes, you heard that right! No matter what kind of business you own, you can build custom modules to store the kind of information that you like.

Sounds exciting, doesn’t it? So channelize the developer in you and read on for details.


Let us begin by learning what a module is. 

Technically, a module is a set of independent units that have similar characteristics. A CRM module is something alike. It is a set of records that store a particular type of information.

Here is an example to give you a clear understanding. 

A famous tradeshow is being held at a nearby convention center. You participate in the tradeshow where you set up a counter to showcase your products. Interested prospects leave their name and contact details in a register to get a demo of your products.

Now, instead of using the register, you can store the name and contact details in a CRM record. And you can create this record in the Leads module of Vtiger CRM.

Similarly, you can have different modules for different types of information. Because customizability is one of Vtiger CRM’s core possibilities, you can create custom modules as per your business requirements. 

Now that we have an idea about modules, let us learn how to create one.

Creating a Module

Creating a module involves five steps.

  1. Accessing the Module Management settings
  2. Specifying the module properties
  3. Creating blocks and fields
  4. Choosing columns for your default lists
  5. Creating relationships with other modules

We’ll look at all the five 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 you need to assign a special workforce to it. You can create a module called Workforce under the Projects app. 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.


Now, let’s deep-dive into the procedure!

Follow these steps to create a module:

Step 1: Access the Module Builder

In this step, we’ll learn how to view the Module Builder in the CRM.

  1. Click the User Menu on the top right corner of the screen.
  2. Click the Settings button.
    • You will land on the Settings page.
  3. Look for the Module Management section.
  4. Click Module Builder.

Step 2: Specify the Module Properties

To build a module, you must specify its basic details. 

  1. Enter the following information:
    • Module Label - Specify the module name. For example, Workforce
    • 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.
    • Select App Category - Select the app under which you want to create the module. For instance, you will create Workforce under Projects.
    • 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 the Create button.

Step 3: Create Blocks and Fields


Note: Some fields are provided by default in the Basic Information block. You can also create custom fields and blocks if needed.

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

Step 4: Choose the Default Filter

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

  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 the Next button.

Step 5: 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.

  1. Click the +Add Relationship button (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.
    • If you consider the example above, you must choose Projects from the drop-down. Projects becomes the related module.
  3. Pick a relationship type under Select relationship type.
  4.  Specify the names of the related and custom module field/tab 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

You can delete only custom modules. Deleting a custom module does not affect the existing modules.


Note: You can delete a module only if you are an Admin user.


Follow these steps to delete a custom module:

  1. Click the User Menu on the top right corner of the screen.
  2. Click the Settings button.
    • You will land on the Settings page.
  3. Look for the Module Management section.
  4. Click Modules.
    • You will see a list of all the modules available in the CRM.
  5. Look for the desired module.
  6. Hover over the More icon on the module name.
  7. Click the Delete option.
  8. Click the Yes button to confirm.
Home Privacy Policy Terms of Service Security Center Policy & Legal Center
© Copyright 2021 Vtiger. All rights reserved.
Powered by Vtiger
Facebook Twitter Linkedin Youtube