Skip to main content
A status is one colour-coded label applied to one contact. Unlike groups (many per contact) or custom fields (data values), a status is a single, exclusive tag that answers: “What kind of contact is this, right now?”

Status record

Each status has:
  • Name — the label shown in dropdowns (min 3 characters, max 255, unique within your workspace).
  • Colour — a hex colour code (up to 7 characters, e.g. #FF0000). Used to colour-code the status badge wherever it appears.
  • Default flag — marks one status as the default applied to new contacts that come in through channels that don’t specify one.
A contact always has one status at a time. Changing the status replaces the previous one.
Xobito does not ship pre-seeded statuses. You define them to match your own sales or support lifecycle.

Typical statuses

StatusWhen to use
New leadJust came in, hasn’t been qualified yet.
Hot leadHighly engaged, ready to buy.
CustomerHas made a purchase.
InactiveNo engagement for 90+ days.
UnsubscribedAsked to stop receiving messages.
BlockedMarked your messages as spam, or abusive behaviour.

Status vs. Group vs. Custom Field

New users often confuse these. Quick guide:
ConceptHow many per contactUse for
StatusOneLifecycle stage (“Hot lead”, “Customer”)
SourceOneWhere they came from (“Website”, “Referral”)
GroupManyMarketing segments (“VIP”, “Newsletter”)
Custom fieldMany (one value each)Data (“Plan: Pro”, “Birthday: 1990-05-12”)
If you find yourself wanting two statuses on one contact, split the idea: one becomes a group, the other stays as status.

Open the Status library

In the sidebar, go to Contacts → Status. This is where you manage the full list of statuses available to your team.

Create a status

1

Click 'Add Status'

Opens the status form.
2

Give it a name

Min 3 characters, max 255. Must be unique within your workspace. Keep it short and consistent — “Customer” not “customers”.
3

Pick a colour

Choose a hex colour (up to 7 characters, e.g. #22C55E for green). Red for “Unsubscribed”, green for “Customer”, amber for “Hot lead” is a common scheme.
4

Mark as default (optional)

If you want this status to be applied automatically to incoming contacts that don’t have a status set, tick the default flag. Only one status should be default at a time.
5

Save

The status is immediately available in the contact form and CSV imports.

Edit or delete a status

1

Open Status library

Contacts → Status.
2

Find the row

Use search if you have many statuses.
3

Edit or Delete

Editing a status renames or recolours it across every contact. Deleting removes the status — reassign contacts using it first.
Before deleting a status, reassign the contacts currently using it. Otherwise those contacts will have no status — and every contact in Xobito needs a status.

Assign a status to a contact

On the contact form

When creating or editing a contact, pick a status from the dropdown. This field is required. See Add a Contact.

During CSV import

Include a status_id column in your CSV with the numeric ID of an existing status. See Import from CSV.

From an automation

A Bot Flow can change a contact’s status as part of its logic — for example, “If the user answers ‘yes’ to ‘Are you interested?’, set status to Hot lead.” See Bot Flows.

Filter and report by status

  • In the contact list, filter by status to see only contacts with a specific label.
  • In campaign analytics, engagement can be split by status.
  • In Bot Flows, branch a conversation based on the contact’s current status.

Best practices

5 to 10 statuses is usually enough. If you need more granularity, you probably want groups or custom fields instead.
When a contact asks to stop receiving messages, switch them immediately. Never include unsubscribed contacts in marketing campaigns.
Set exactly one status as default so incoming contacts always have a valid starting point.
Statuses only work if everyone uses them the same way. Write a short “what each status means” guide for your agents.
A Bot Flow can update a contact’s status based on their replies, keeping the database accurate without manual work.

Sources

Track where each contact came from.

Groups

Create marketing segments your contacts can belong to.

Custom fields

Store arbitrary data points per contact.

Bot flows

Automate status changes based on conversations.