A reference is an optional tag you attach to a recording link when you create it. References connect recordings to external systems like issue trackers and help desks, making it easy to find the right recording later.
What is a reference?
A reference is a free-text field on a recording link. You can enter anything that helps you identify the recording:
- A Jira ticket number:
JIRA-456
- A GitHub issue URL:
https://github.com/org/repo/issues/123
- A Zendesk ticket ID:
ZD-78901
- A customer name or internal identifier
Adding a reference
When creating a recording link manually, enter the reference in the Reference field. References are optional — you can leave the field blank.
When using Userplane native integrations like Intercom to create recording links, the reference is automatically populated with the relevant ticket or conversation identifier. No additional input is needed.
Finding recordings by reference
References appear in the recording list and detail views. You can use the search and filter controls on the Recordings and Links pages to find links and recordings by their reference. Additionally, Userplane uses these identifiers for recording and integration metadata.
Tips
Use consistent reference formats across your team (e.g. always use the full Jira ticket key).
References are displayed in the recording info panel, so anyone reviewing the recording can see
the connected ticket. You can update a link’s reference after creation by editing the link.
