Using lookup relationship fields

EditedJanuary 03, 2023 23:20

Zendesk Documentation Team

A lookup relationship field is a custom field that you can use to establish relationships between tickets, users, and organizations.

This article contains the following topics:

You can use the Zendesk API to retrieve lookup relationship data. For example, you can request a list of all tickets related to a specific support manager. To learn more, seeRetrieving lookup relationship data with the APIin the developer docs.

Understanding lookup relationship fields

A lookup relationship field is a type of custom field type that you can add to users, organizations, or tickets in Zendesk. SeeAbout custom field types．After adding a lookup relationship field, team members can use it to establish relationships with other users, organizations, or tickets.

You can add a lookup relationship field to ticket forms, user profiles, and organization pages. When you do, users can use this field to look up and select from a list of users, organizations, or tickets in your Zendesk account.

You can use lookup fields in creative ways that serve your specific business needs. For example, you could create a lookup field called Manager, tie that lookup field to your account's users, and add the field to your ticket form. Your agents could then use this field on a ticket to select a manager from a list of your organization's users.

Topics covered in this section:

Understanding the custom field

A lookup relationship field is a custom field that lets you look up and select from a list of users, organizations, or tickets in your Zendesk account. The following example shows a lookup relationship field on a user profile page. A team member typed a dash (-) in the field to list a filtered set of organizations in the account:

The list of options in a lookup relationship field is auto-populated as you type into the field. You don't have to define the options yourself as you do with a dropdown custom field, though you can filter them when you define the field (seeFiltering the field's options）.

在选择一个选项, you can view the record details by clicking the field name:

You can add lookup relationship fields to the following pages in the Zendesk interface:

Tickets or the support request form in your help center
The user profile page
The organization page

These pages represent the possiblesource objectof a relationship. For example, a user displayed in the user profile page can be the source object of a relationship with another user, organization, or ticket. The lookup relationship field lets you select the other object — also known as therelated object— in the relationship.

You can make a lookup relationship field conditional so that it only appears to agents and end users some of the time under certain circumstances. SeeCreating conditional ticket fields．

Understanding the relationships

A lookup relationship can be expressed as follows:

source object→related object

The source object is the Zendesk object that contains the lookup relationship field (among other fields). It can be a user, organization, or ticket. The related object is the object specified by the lookup relationship field. It can also be a user, organization, or ticket. Lookup relationships with Zendesk custom objects are not supported.

A lookup relationship can be any combination of a user, organization, or ticket with another user, organization, or ticket.

If you create a relationship between a source ticket and a related user, the ticket record will have a lookup relationship field identifying the user. However, the corresponding user record will not have a field identifying the ticket. Instead of a field, the user record will have aRelatedtab listing the ticket along with all the other source objects it’s related to (seeViewing lookup relationships for users and organizations）.

Each source object can be related to only one related object. However, many source objects can be related to one related object. For example, after adding an organization lookup relationship field to users, you could then establish many relationships between users and one organization. Example:

User 1 - Org A
User 2 - Org A
User 3 - Org A
．..

Important:This example does not add the user to the organization. It just establishes a relationship between the user and the organization.

You can view the relationships in ticket forms, user profiles, and organization pages.

You can also use the Zendesk API to list the users, organizations, or tickets related to a specific related object. For example, you can request a list of all tickets related to a specific support manager. To learn more, seeRetrieving lookup relationship data with the APIin the developer docs.

Searching records by lookup relationship field values is not supported.

Examples

There are many ways you can use lookup relationship fields to build out complex relationship ecosystems within Zendesk Support. The following are some examples to help you start thinking about ways you can use these custom fields:

You're an admin for a trucking company and you want to associate shippers, drivers, and recipients with tickets. You add three filtered lookup relationship fields to tickets: a user field namedDrivers, an organization field namedShippers, and another organization field namedRecipients．
Your company is in the business-to-business (B2B) space and interacts with many other companies. You want to track the relationships these companies have with each other. You decide to use organization lookup relationship fields to create and track these relationships. For example, you might have a field namedPartner, a second namedSubsidiary, and a third named竞争对手．
In another business-to-business scenario, each of your account managers works with a key stakeholder at each of your customer companies. You create a user lookup relationship field namedAccount Managerto establish relationships between the stakeholders and your account managers.
You want to designate emergency contacts for members on your team in case a member is not available. You decide to use a user lookup field namedEmergency Contactto create these user-to-user relationships. In a more complex use case, you could add additional user fields --Backup 1,Backup 2– to establish a priority of backups for each person.

Adding lookup relationship fields

You can add up to ten active or inactive lookup relationship fields to users, organizations, and tickets. The field is displayed on pages in the Zendesk interface.

You can also create lookup relationship fields with the Zendesk API. SeeLookup Relationshipsin the API reference docs.

If you delete a lookup relationship field, the data in the field isn't preserved. To preserve the data, deactivate the field rather than deleting it.

To create a lookup relationship field

Start by adding a custom field to your users, organizations, or tickets and selectLookup relationshipas the custom field type. For more information, see:
Example:
Set theDisplay name,Field key, andDescriptionas described in the articles linked from step 1.
Select a related object to list in the lookup relationship field.
This can be a Ticket, User, or Organization. For example, if you select User as the related object, the lookup relationship field will display a list of Zendesk users.
ClickAdd filterto define one or more filters to reduce the number of options that the field can display.
You can filter objects by any number of tags or custom fields. For more information, seeFiltering the field's options．
ClickSave．

Filtering the field's options

Your account could have thousands or even millions of ticket, user, and organization records. In most cases, you'll want a defined subset of records for the options in your lookup relationship fields. For example, you might want to list only users who are account managers.

By default, all lookup relationship fields let you filter the records of the related object by tag. For example, to list only users who are account managers, you could add an "account_manager" tag to the user profiles of your account managers and then define the following filter condition for the lookup relationship field:

Tags | Contain at least one of the following | account_manager

For ticket records, the following additional default filters are available: Status, Type, Priority, Assignee, Requester, Form, Organization, and Channel. SeeBuilding trigger condition statements．For user records, an additional Role filter is available.

Lookup relationship fields also support filtering by other custom fields added to the related object. For example, if you add aSecurity Clearancecustom checkbox field to the user profile, theSecurity Clearancefield will appear as a filter option when you add the lookup relationship field. You could then define the following filter condition for the field:

Security Clearance | Is | Checked

You can modify the filters at any time. This won't affect the values previously selected with the lookup relationship field.

To learn more, seeAbout custom fields．

Viewing lookup relationships for users and organizations

Each Zendesk Support profile for ateam member,end user, ororganizationincludes aRelatedtab that lists all related source objects. The information is grouped by the type of source object (Tickets,Organizations, orUsers) and the specific lookup field.

In the following example of a team member profile, tickets have a lookup relationship field calledDriver．如果安妮波特在选择eDriverfield, that ticket appears under theRelatedtab on her team member profile. It’s grouped by the type of source object,Tickets, and the name of the lookup field,Driver．

TheRelatedtab doesn’t appear onuser profiles in your help center．