Set up pipelines
A workspace admin decides what a lead and a project are called, and which steps they move through. Open Admin › Records › Pipelines.
Record names
Under Record names, give each kind a word for one record and a word for several: a lead can be an Opportunity, a project an Engagement. Press Save. Every app uses the new words after its next refresh: in New… menus, titles, lists, search and empty screens. Links, agents and the help pages keep the words lead and project.
Pipelines and stages
Each kind has one or more pipelines. One is the Default: a new record starts there unless someone picks another. Leads appear here when Sales is on.
- Add pipeline starts one with a stage of each kind it needs.
- Each stage has a name and a kind. A lead's stage is Open, Won or Lost; a project's is Open or Done. Every pipeline needs an open stage, and a lead pipeline also needs a won stage and a lost stage. The kind decides when a record leaves your open lists, and Win moves a lead to its pipeline's first won stage.
- Use the arrows to change the order. A new record starts in the first open stage.
- Remove a stage with the bin. Before you save, choose where its records move.
Press Save to save the kind's pipelines in one go, or Discard changes.
Stage rules
Open Rules on a stage:
- Checklist: items to tick while a record is in the stage. A checklist never stops a move.
- Tasks on entry: tasks Starlings adds to the record the first time it enters the stage, each on your team or the client, with an optional due date a number of days later. Moving back into the stage does not add them again.
- Required to enter: fields a record must have before it can move into the stage. A move without them is refused, and the message names what is missing.
Win does not check required fields, and moving records while removing a stage runs no rules.
On a workspace whose records still live in Core, the stages are read-only. The names work everywhere.
Where it works
| Capability | macOS Host | macOS Join | Web | iOS / iPadOS | Agent access |
|---|---|---|---|---|---|
| Pipelines, stage rules and record names | Works | Works | Works | Works | task (MCP), /api/admin/pipelines |
Verified · docs/help/howto/set-up-pipelines.md