Project and playbook data fields
Updated
Every data field has an object type. Two of them are Project and Playbook. A field's object type, together with its Add on creation setting and the playbooks it's attached to, decides which projects it shows up on.
You set the object type when you create a field under Settings > Data fields. The list on that page calls the same setting Location. To create one, see Create and use data fields in OnRamp.
When to use it
Every project needs the field. Create a Project field and turn on Add on creation. It's added to every new project, whichever playbook it came from.
Only some playbooks need the field. Create a Project or Playbook field, leave Add on creation off, and attach it to those playbooks on their Data Fields tab.
One project needs the field. Use a Project field with Add on creation off, and add it to that project after it's created.
How it works
Who can manage data fields
Contributors and Collaborators don't see Data fields in Settings. Only people allowed to edit data field definitions see New data field, the button that creates a field.
Add on creation
Both object types have an Add on creation setting:
On a Project field, it adds the field to every new project.
On a Playbook field, it adds the field to every new playbook.
With Add on creation off, a Project field isn't added anywhere on its own. You can still attach it to specific playbooks, or add it to an individual project after the fact.
A playbook's Data Fields tab
Open a playbook and go to its Data Fields tab to attach fields to it. You can attach both Project and Playbook fields here. A field is saved as soon as you add it, and OnRamp confirms with a Data Field added message. Only people with permission to update the playbook can edit this tab. Even then, the tab is read-only unless you're working in a draft of the playbook, so open or create a draft before you add fields.
On the tab you can:
Drag fields to reorder them.
Choose which fields are visible. Visible fields appear, in the tab's order, in the Data Fields strip at the top of the playbook and of its projects. A project copies the playbook's order and visibility when it's created, so later changes on the tab don't reach projects that already exist.
Adding fields to a project after it's created
On a project created from a playbook, both Project and Playbook fields show up as fields you can add. On a project that wasn't created from a playbook, Playbook fields are hidden, so you can add only Project fields there.
Required value
A field's Required value setting marks it as required. On a playbook's Data Fields tab, once a required field has a value, you can change the value but you can't clear it.
Filling fields from your CRM
Workflows can set data field values when they create a project. Open the workflow from Workflows. Its Project Data Fields card appears only when the new project would get at least one data field: the selected playbook's fields, plus every Project field with Add on creation on. For each field, the source dropdown depends on the field's type. Text and Link fields offer Fixed, From trigger object and Merge fields. Duration fields offer only Fixed, and every other type offers Fixed and From trigger object. To use a value from the CRM record, select From trigger object and then select the field.
If the new project would get no data fields, from the playbook or from Add on creation, and your organization has no active Account fields, the workflow shows No project or account data fields to set. For the full steps, see Mapping CRM data into OnRamp using data fields.
Limits
Playbook fields can't be added to a project that wasn't created from a playbook.
Fields managed by Journeys don't have the Edit field or Archive field actions on the Data fields list. For a formula field, Edit field is unavailable when formula fields are turned off for your organization or the field is archived.
Archived fields don't appear on the list's Active filter. To check a field's object type, filter the list by location. If a field is missing from new projects, see Why aren't my data fields showing up on new projects?