Reference & Related Items
The Reference tab is where you connect a project to everything else in the portal that's relevant to it — a brand kit Resource, a piece of Equipment Asset, a client Location, an open Ticket, a signed Contract, a completed Intake form, or any external URL.
What the Reference Tab Does
References are lightweight links — they point at other content in the portal (or any URL) without copying it. Open the project, click any reference, you jump straight to it.
References are visible to everyone who can view the project, so use them to create a single browsable index of all the context a teammate or client needs.
Enabling the Tab
The Reference tab is disabled by default. To turn it on, edit the project's project_tab_config (see Per-Project Tab Configuration) and set related → enabled: true.
Once enabled, the tab shows in the project's tab row with the diagram icon.
Item Types
ClientCove supports six post-type references plus URL references:
| Type | Color | Icon | Use For |
|---|---|---|---|
| Resource | Yellow (warning) | Document | Brand kits, guides, deliverables, FAQs |
| Asset | Blue (primary) | Network | Equipment, hardware, infrastructure items |
| Location | Green (success) | Map pin | Physical sites, offices, addresses |
| Ticket | Cyan (info) | Ticket | Support requests related to this project |
| Contract | Red (danger) | Document check | Signed agreements, SOWs |
| Intake | Dark | Clipboard check | Submitted intake forms |
| URL | — | Link | Any external link |
Each reference shows the item's title, a subtitle (e.g. asset type, location address), and a status badge where applicable.
Adding an Item
- Open the Reference tab
- Click + Add Reference
- A picker modal opens — search by title, filter by type
- Click an item to add it to the list
The reference appears in the tab immediately. You can add the same item multiple times if needed (e.g. once standalone, once inside a group).
Adding a URL Reference
- Click + Add URL
- Paste the URL
- Optionally set a custom title (defaults to the URL)
- Save
URL references appear with a generic link icon and open in a new tab when clicked.
Grouping Items
To organize references when you have many:
- Click + Add Group
- Name the group (e.g. "Brand Assets", "Approvals", "External References")
- Drag existing references into the group, or add new ones inside it
Groups can be collapsed for visual tidiness. Drag groups themselves to reorder.
Reordering & Deleting
- Drag any item or group by its handle to reorder
- Hover an item to reveal the delete (X) action
- Confirm to remove (this only removes the reference link — the underlying Resource, Asset, etc. is untouched)
References are a per-project list. Removing a reference here does not affect the original item or any other project that references it.