Tags

Tags are short colored labels you put on your records, such as Retainer, Rush job or Key account. They show right under the record's name, so your team sees at a glance what kind of work or customer it is.

How tags work

Records in the areas below have a row of tags under their name, on every tab of the record. Use them for whatever helps your team sort work: the type of service, a priority, an industry, a region, or a reminder that something needs a second look.

A separate tag list for each area

Each area of Belvak keeps its own tag list. Client tags are only offered on clients, project tags only on projects, invoice tags only on invoices, and so on. This keeps each list short and relevant, and a tag made for one area can never end up on a record from another. You can tag records in these areas:

  • Projects
  • Clients
  • Invoices
  • Proposals
  • Service Contracts
  • Payments
  • Service contract payments
  • Expenses
  • Suppliers
  • Employees
  • Payroll
  • Candidates
  • Referral Partners
  • Commissions

The same name in different areas

Because the lists are separate, the same name can exist in more than one area. You can have a VIP tag for clients and another VIP tag for projects, each with its own color. Inside one area a name is used once: if a tag with that name already exists there, Belvak offers the existing tag instead of making a second one.

Shared by your whole team

Tags belong to your workspace, not to one person. Every tag in an area is available to your whole team, whoever created it. What each person can do with tags depends on their role, as explained in who can use tags.

Adding and removing tags

Adding a tag to a record

  1. Open the record, for example a client or a project.
  2. Under its name, click + Tag (or + Add tag when the record has no tags yet).
  3. Start typing to search the area's tags.
  4. Click a tag to add it. A check mark shows the tags the record already has.

The change saves straight away. You do not need to open the edit form or press save.

Creating a new tag

If no tag matches what you typed, the list offers Create "your text". Pick a color from the dots underneath, then click Create or press Enter. The new tag is added to the record and joins the area's list for everyone on your team.

Removing a tag

Click the small x on the tag, or open + Tag and click a checked tag to take it off. Removing a tag from one record does not delete the tag: it stays available for your other records.

When there are many tags

Tags stay on a single line. When they do not all fit, the last ones fold into a +N chip: click it to see the full list. Long tag names are shortened, and hovering over one shows the full name. On a phone, the full list and the tag picker open from the bottom of the screen.

Project tags in the projects table

On the Projects page, tags also show as a column, and you can filter the table by tag to pull up every project of a certain kind. You can still pick tags while you add or edit a project, and duplicating a project copies its tags.

Managing tags in Settings

Go to Settings > Tags to see and tidy up every tag in one place. You can also get there from any record: open + Tag and click Manage in Settings, which opens the list for that record's area.

Choosing an area

Pick an area from the Module list at the top to see its tags. For each tag you see:

  • Tag: its name and color.
  • Used on: how many records carry it.
  • Created by: who made it. Tags made before Belvak started recording this show Unknown.
  • Created: the date it was made.

Renaming and recoloring

Click the pencil next to a tag to rename it, and click its color dot to pick a new color. The change shows on every record that already carries the tag, so there is no need to re-tag anything.

Adding a tag ahead of time

Click New tag to set up a tag before anyone uses it, for example to agree on a shared list with your team.

Deleting a tag

Click the bin icon on a tag. Belvak tells you how many records use it before you confirm. Deleting a tag removes it from all those records and from the area's list. This cannot be undone, so if you only want it off one record, remove it there instead.

Managing tags from other apps

On the Professional plan, tools connected through the Belvak API can list, add, rename and delete tags and set them on records, with the same rules as here: a tag stays in its own area and names are unique inside an area. See Authenticating requests to get started.

Who can use tags

The Tags permission

Tags have their own Tags permission in roles and permissions. It works together with the permission for each area:

  • View: the person sees the tag row on records and the Tags tab in Settings. Without it, the tag row is hidden.
  • Add: the person can create new tags. Without it, they can still pick from the existing tags, but the Create option does not appear.
  • Edit: the person can rename and recolor tags in Settings.
  • Delete: the person can delete tags in Settings, which also removes them from the records that use them.

Tagging a record needs edit rights on it

To add or remove tags on a record, a person also needs permission to edit that kind of record. Someone who can only view invoices, for example, sees an invoice's tags but cannot change them.

Tag history

Tag changes are recorded, so you can always see who tagged what and when.

On the record's Activity tab

When someone adds or removes tags from the row under the record's name, the record's Activity tab shows it with the tag names, for example "Tags changed: added Retainer, removed VIP". When a tag is created while tagging a record, it reads "Created tag Retainer and added it". People without the Tags view permission see only "Tags changed", without the names.

This works on every record that has an Activity tab: projects, clients, invoices, proposals, service contracts, expenses, employees, payroll, candidates and referral partners. Payments, suppliers and commissions have no Activity tab, so their tag changes appear only in the activity log described below. Tags changed from a project's edit form show there as a regular project update.

In the activity log

Every tag change on a record, and creating, renaming, recoloring and deleting tags, is also recorded in the activity log in Settings, with the area and the person who made the change.

Related Articles