Custom Objects Bundle

Description

Mautic is built around contacts. Every piece of business data — subscriptions, orders, memberships, support tickets — gets flattened into contact fields or ignored entirely. This works at small scale. It breaks when your data has structure.

The Custom Objects Bundle adds a proper data layer to Mautic 7. You define object types with typed fields, create and manage item records, link items to contacts, and use that structured data across the full Mautic workflow — segments, campaigns, forms, and email tokens.

You do not need a separate CRM or a custom integration layer. The data lives in Mautic and behaves like a first-class citizen.

Who It Is For

• –Admins and operations teams that need to model business data without external tools
• –Agencies building Mautic deployments for clients with non-standard data requirements
• –Technical marketers who want segmentation and automation driven by real business records

Features

• –Define custom object types with any combination of typed fields (text, number, date, select, boolean, relation)
• –Create, read, update, and delete object items from the Mautic admin UI
• –Link object items to one or more contacts with named relationships
• –Filter segments using custom object field values and relationship conditions
• –Add campaign decision nodes and action nodes based on object data
• –Embed custom object fields as inputs in Mautic forms
• –Reference object item values as tokens in email content
• –Query and write object items through the Mautic REST API
• –Import items in bulk from CSV with field mapping
• –Export object items to CSV for reporting or migration

Installation

This plugin requires Mautic 7 and PHP 8.1 or later.

composer require codefixerz/mautic-custom-objects-bundle
php bin/console cache:clear
php bin/console mautic:plugins:reload

Enable the plugin from Settings → Plugins in the Mautic admin panel, then define your first object type under Custom Objects in the main navigation.

Configuration

Object types are configured through the admin UI — no code or config file changes required. Each object type has:

• –A name and singular/plural label
• –A set of typed fields
• –Optional relationship definitions to contacts or other object types

API access uses your existing Mautic API credentials. No additional authentication setup is needed.

What It Does Not Do

• –This is not a general-purpose database builder
• –It does not replace a full CRM for complex account hierarchies
• –It does not configure itself automatically — you define your object model first