Add an object
Administrators add objects in Settings → Custom objects.- Press New object.
- 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.
- Choose an icon and a colour. They show in the menu, like the built-in places.
- Add a short description if you like. The web address is made from the name.
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.
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.
Menu order
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.
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.
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).
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.