Skip to main content
A custom object is a kind of record your business needs that Marro does not have built in: Vehicles for a car dealer, Courses and Applications for an education consultancy, Properties for an estate agent. Each object gets its own place in the menu, a list that works like Leads, a board, a calendar and a page for every record. The object is the kind of thing (Vehicles). Each entry in it is a record (one vehicle).

Add an object

Administrators add objects in Settings → Custom objects.
  1. Press New object.
  2. Give it a name in the plural, such as Vehicles. One record is called fills in the singular (Vehicle); change it if the guess is wrong.
  3. Choose an icon and a colour. They show in the menu, like the built-in places.
  4. Add a short description if you like. The web address is made from the name.
Every object starts with one field for the record’s name. Add the rest on the object’s page.

Start from a ready-made set

Below your objects, Start from a ready-made set offers sets for education (Universities, Courses, Applications), real estate (Properties, Site visits), clinics (Treatments, Packages), automotive (Vehicles, Test drives) and services (Projects, Contracts), with the one for your kind of business first. Add shows every object, field and stage it adds before anything changes. Everything can be renamed, added or removed afterwards. An object you already have by the same name is left as it is.

Describe what you need

Press Describe what you need, or tell Marro in the assistant or on WhatsApp, for example “I run a driving school; I need Vehicles, Instructors and Lesson bookings”. Marro asks what you keep track of, proposes the objects, their fields, links between them and stages in plain words, and changes the proposal until it is right. Nothing is added until you approve. Later, ask Marro to add or change fields the same way.

Fields

On the object’s page, Fields lists them in the order the form shows them. Press Add field and choose:
  • Short text, Long text, Number, Date, Phone number, Email address, Link
  • Dropdown (one choice) or Multiple choice: type each choice on its own row
  • Yes / no
  • Money (in a currency you choose when adding the field; it starts as your organisation’s), Percent, Date and time
  • Person in your team
  • Link to another record: a lead, contact, company, opportunity, person in your team, or a record of another object. Choose whether it holds one record or several.
Give a dropdown’s choices a colour with the dot beside each one; the colour shows in the list and on the board. For each field you can add help text, make it required when adding or when editing, hide it, or show it only when another field has a certain answer (for example, show Other reason only when Reason is Other). A field’s type cannot change after it is added; add a new field instead. Filled in to start with sets a default: new records start with that value, and people can change it. No two records the same (for text, phone, email, link, number and money fields) stops two records having the same value, such as a registration number, ignoring capitals and spaces. It holds across every record of the object, including ones some people cannot see, so adding a value that is already taken is refused. If some records already share a value, Marro asks you to make them different first. Use the ⋯ menu on a field to move it up or down. The preview beside the fields shows the form exactly as people will see it when they add a record. Deleting a field keeps its values for 30 days. Before it goes, Marro says how many records have a value and what still uses it (a saved view, or a field shown only when this one has an answer). Type the field’s name to confirm. Restore it from Recently deleted within 30 days.

Stages

An object can have one stage list, such as Draft, Submitted, Accepted, Enrolled. Add a dropdown field with the stages as its choices, then choose it under Details → Stages. Each stage can have a colour, and says whether a record there is still going, won or lost. With stages, the board starts by stage, the record page shows the stage at the top (change it there) and since when the record has been in it, and every change of stage is in the record’s activity. A link that needs details of its own, such as a student applying to a course with an intake and a status, is best kept as an object of its own in the middle (Applications), linking to both.

How records show

How records show sets, for everyone:
  • In the list: which fields are columns when someone opens the list (each person can still change their own).
  • On cards: up to three fields shown on board cards under the name.
  • Calendar date: which date field the calendar uses first.
On Settings → Custom objects, use ⋯ → Move up or Move down to set the order objects appear in the menu. They are listed after Leads. With more than six, the rest are under More.

Who can see it

Under Who can see it, each role has:
  • Sees: nothing, their own records, their team’s, their branch’s, or all records. “Team” means the teams the person leads; “branch” means the people in the branches they manage, as for leads.
  • Add, Edit, Delete and Download.
Administrators always see and change everything. Partners cannot open custom objects. Access to an object does not give access to leads. The Roles page links to each object’s settings.

The list

Open an object from the menu. The list works like Leads:
  • Search finds records by their name, anywhere in the name.
  • Filter narrows the list by any field, the owner or when records were added or changed. Filters in use show as chips; open the full filter to combine several with “and” or “or”.
  • Views saves the search, filters, sort and columns, for yourself or for everyone.
  • The columns button chooses which fields are columns, up to 12.
  • Click a column heading to sort by it.
  • Click a value in the list to change it there and then.
  • Tick records to change a field on all of them, give them to someone, archive or delete them, up to 50 at a time.
⋯ at the top has Show archived, Import, Download and, for administrators, the object’s settings. Large lists stay quick: when more than 10,000 records match, the count shows as 10,000+. On a phone the list shows each record’s name with two of its fields and its owner.

Board and calendar

Board shows records in columns by a dropdown field, such as Status. Drag a card to another column to change it. With several dropdowns, choose which one makes the columns. Cards show the fields chosen under How records show. The search and filters apply to the board too. Calendar shows records on the month by one of their date fields. Use the arrows to move between months. On a phone it lists only the days that have records.

Add and edit records

Press Add (for example Add vehicle) at the top of the list. The form opens at the side; fill it in and press Add. You can choose the owner; leave it as Me to own the record yourself, or choose a team: the record goes to whichever member’s turn it is (the one who was given one longest ago). Open a record to see its details, what it links to, what links to it, and its activity: who added it, who changed what (for example “Status: Draft → Submitted”), and notes. Edit opens the same form. The owner can be changed at the top of the page. ⋯ has Archive (it leaves the list and keeps its history; restore it from Show archived) and Delete. When a record links to a lead (a student on an application, a buyer on a site visit), its page also shows that person: Call and WhatsApp buttons, + to add a follow-up for them, their open follow-ups and documents, and their latest calls, chats and emails. With the assistant, a record’s ⋯ menu also has Summarise with Marro (where it stands, what changed, the linked people’s latest calls and chats) and Fill in from a chat or call: Marro reads the latest WhatsApp chat or call with the person the record links to and suggests values for the fields it answers, and changes nothing until you approve. If someone else changed the record while you were editing, saving is refused so their change is not lost. Reopen the record and make your change again.

Recycle bin

Delete moves a record to its object’s recycle bin (⋯ → Recycle bin on the list). From there, Bring back returns it with its notes and activity, for 30 days; after that it goes for good. To remove one for good straight away, use the bin’s delete button and type the record’s name.

Import and download

⋯ → Download saves the records as filtered and sorted on screen, up to 50,000, as a spreadsheet (CSV). ⋯ → Import reads a CSV file of up to 1,000 rows. Match each column to a field (or leave it out), check the first rows, then import. You can choose who owns the new records, a person or a team taking turns. To update records you already have, mark a field No two records the same (a registration number, an email) and choose Update the one with the same …: a row whose value is already on a record changes that record, and the others are added. Rows that could not be saved can be downloaded as a file with the reason for each, to fix and import again. Downloading a file needs the role’s Download permission (it does not stop people seeing the records they may see in the list).

Reports

Each object is a source in custom reports: choose it under Report on. Count its records, or add up, average or find the highest of a number, money or percent field. Group or split by its dropdowns, yes/no fields, people fields and Owner, by the date it was added, last changed, moved to its stage or a date field of its own, and by the linked lead’s stage, source, owner, team or fields (a record linked to several leads counts under the first; one with none under No linked lead). Filter narrows it on the object’s own fields. Save it, put it on a dashboard or have it emailed. Each person sees the figures for the records they may see; a dashboard’s lead filter does not apply to object reports. Reports → Custom object reports stays for a quick count, with the records behind each group; Make a chart opens the same object in a new report.

Automations

Automations can start when A custom object record is added, A custom object record changes (any field, or only the ones you choose) or A custom object record’s stage changes (into any stage, or only some). They run for each lead the record links to, such as the student on an application; a record that links to no lead starts nothing. Changes made by automations start nothing, so automations cannot loop. Two steps work on records for the lead:
  • Add a custom object record adds one, linked to the lead, with the values you set (text can use {{lead.name}} and the like). Run twice, it adds it once.
  • Change the lead’s custom object records sets the fields you choose on every record of that object linked to the lead (up to 20).
Steps act as the person who set up the automation, so that person’s access to the object applies.

Ask Marro and staff WhatsApp

The assistant can list objects and their fields, find and read records (including by board, calendar date or owner), and, after you approve, add and change records, add notes, change an object’s settings, fields and menu order, and set who can see it. The same access rules apply as on the screens.

Webhooks and integrations

Zapier, Make, n8n and custom webhooks (Settings → Integrations) can be sent A custom object record is added, changes, moves to another stage and is deleted. Each call carries the object, the record with its fields and a link to open it.

Website forms, the customer portal and the Inbox

  • A website form can add a record to an object instead of a lead.
  • An administrator can share chosen fields of one record with a linked lead in their customer portal, from the record page.
  • In the Inbox, the lead panel lists records linked to that lead.

API

Keys with the custom object scopes can list objects, read, add, change and delete records, and list the records linked to a record; see the API reference. Large lists page by position (cursor), and updated_since returns only records changed since a time. Send an Idempotency-Key header when adding a record so a retry never adds it twice. Deleting moves the record to the recycle bin.

Limits

Your plan sets how many objects and records you can have: Growth includes 3 objects and 50,000 records, Complete sets no object limit of its own (any organisation can have up to 20) and 500,000 records. Records are counted across every object, archived ones and those in the recycle bin included (until it is cleared). Each object can have up to 100 fields. Settings → Custom objects → Usage and Settings → Subscription show what you use. When you reach a limit, everything you have stays usable and editable; only adding more is refused, with a message saying so. Delete records you no longer need, or move to a plan with more room. After moving to a smaller plan nothing is removed: you just cannot add more until you are back under its limit.