CRM - Contact Relationship Management

Drupal CRM is the modern community-first platform for building rich Drupal applications involving contacts and their relationships. Built on Drupal best practices, you'll wonder how you built without it!

Overview

Managing contacts, relationships, and complex organizational structures in Drupal often requires cobbling together various contributed modules or integrating external CRM systems. Contact Relationship Management (CRM) is the modern solution. Drupal CRM is built as a set of core-first extensions that fully adopt Drupal's entity architecture, configuration system, and development standards. Instead of relying on heavy integrations or legacy data models, Drupal CRM is designed to be lightweight, extensible, and ready to integrate seamlessly with the rest of the Drupal ecosystem. Whether you're managing contacts, memberships, households, or complex organizational structures, Drupal CRM brings modern best practices into a familiar Drupal workflow.

What does CRM stand for?

CRM often stands for Customer Relationship Management or Constituent Relationship Management. For Drupal CRM, we chose the name Contact Relationship Management because we are not focused on just customers or constituents, but rather any type of contact.

Community-Oriented 👥

Drupal CRM is taking a community-first approach to project development and maintenance.

By bringing many contributors into the fold early on and by promoting independent creation of CRM ecosystem components (i.e. please extend CRM in contrib!), the project can cater to diverse needs, avoid architectural pitfalls, avoid being controlled by a commercial enterprise, and thrive long-term.

The following projects are adopting and/or actively contributing to CRM:

• Open Knowledge
• Member Platform
• ConReg

Have a project to be added to this list? Please create an issue!

Try Drupal CRM

Install on an existing Drupal 11 site

composer require drupal/crm
drush en crm

Install with Simpsons demo content 👧

Install DDEV then run the following commands to demo locally:

mkdir mycrm && cd mycrm
ddev config --project-type=drupal --docroot=web --project-name=mycrm
ddev start
ddev composer create-project "drupal/recommended-project:^11"
ddev composer config minimum-stability beta
ddev composer require drupal/crm drush/drush
ddev drush site:install -y
ddev drush recipe modules/contrib/crm/recipes/crm_simpsons
ddev launch $(ddev drush uli)

Simplytest.me Demo

Try the latest 1.0.x (unstable)

What to Look For

After installing, you can quickly discover most of CRM's functionality at these paths:

• /admin/config/crm
• /admin/structure/crm
• /crm/contact

Architecture 🔧

These are highlights. Much more in the Developer Documentation.

Entity Types

Three content entity types: Contact, Contact Method, and Relationship.

Contact

Three Contact bundles (out of the box):

• Person
• Household
• Organization

Contact Method

Structured, fieldable contact information such as:

• Address
• Email
• Telephone

Relationship

Maps one Contact to another Contact with a configurable, fieldable Relationship Type.

Example Relationship Types:

• Head of household
• Spouse
• Employee
• Member

Dependencies

• Address
• Datetime
• Image
• Inline Entity Form
• Name field
• Primary Entity Reference
• Telephone

Integrations

• Comment
• Group
• Navigation
• ReST
• Search
  • Search API
• Serialization
• User
• Views

Planned Integrations

• Commerce
• Media
• Workflow
• Workspace

Documentation & Resources

Many of your questions can be answered by browsing the extensive Developer Documentation or the documentation page.

Drupal CRM Ecosystem

See projects that extend Drupal CRM.

Similar Projects

See Comparison of CRM modules.

News / Events / Mentions

• MidCamp 2026: Drupal CRM: Architecture, Migration, and Data Interoperability
• Stanford Webcamp 2026: Drupal CRM: An Ecosystem of Features
• Talking Drupal, Episode 548: How to build your own CRM (video)
• Florida Drupal Camp 2026: Drupal CRM: An Extensible Replacement for CiviCRM (video, slides - PDF, slides - Google)
• Gov Webworks: My Journey Toward a Native Drupal CRM
• The Drop Times: Drupal CRM Beta Launches to Replace Node-Based Contact Management
• Talking Drupal, Episode 537 Module of the Week (video)
• Talking Drupal, Episode 512: Member Platform (video)

How to Contribute

The Drupal CRM project is seeking contributors with diverse skill sets to help create the best Drupal-native CRM.

Drupal Slack

If you haven't already, join Drupal Slack, then find us in the
#crm channel where we collaborate on Drupal CRM issues.

Issue Queue

The best way to dive in is to find an issue in the issue queue and tackle it — be bold and take action!

Develop CRM using DDEV ⚙

If you haven't already, install DDEV.

git clone [email protected]:project/crm.git
cd crm
ddev config --project-type=drupal --docroot=web --php-version=8.4 --corepack-enable --project-name=crm
ddev add-on get ddev/ddev-drupal-contrib
ddev add-on get ddev/ddev-selenium-standalone-chrome
ddev add-on get s-ayers/ddev-drupal-contrib-mkdocs
ddev add-on get s-ayers/ddev-drupal-paratest
ddev start
ddev poser
ddev symlink-project
ddev drush site:install -y
ddev drush pm:install crm -y
ddev drush config:export -y
ddev drush user:login
ddev drush recipe ../recipes/crm_simpsons

Consider sponsoring DDEV development.

Every MR on this project automatically generates a live preview environment powered by Tugboat, so reviewers can test changes on a real site without any local setup. Want to add the same to your project? Here's how to get started.

Upgrade Paths

We provide schema and configuration updates. While we strive to avoid breaking changes, they may occur in BETA releases. However, we are committed to providing upgrade paths between all beta, release candidate, and stable versions.

See the Release Candidate Plan.

Note: Drupal's security advisory policy only applies to stable releases.