{"revision":"c10276e953456835cdbb1f3a60d58ae1980be353","document":{"id":38694,"path":"platform-administration/define-email-recipient-qualifiers.md","title":"Define email client recipient qualifiers","bundle":null,"doc_type":null,"release":"australia","body":"\n# Define email client recipient qualifiers\n\nCreate a configuration that controls the auto-complete list of recipients displayed in the email client.\n\n## Before you begin\n\nRole required: email\\_client\\_admin\n\n## About this task\n\nYou can specify recipient qualifiers that display additional fields \\(from a selected ServiceNow table\\) in the auto-complete list. These fields differentiate email recipients who have the same first and last names.\n\nUse the following tabs in the Email Client Recipient Qualifier form to define a recipient configuration.\n\n-   **Display Configuration** – Set up the email recipient auto-complete behavior and optionally select additional fields to differentiate recipients who have the same name. The additional fields ensure that users select the proper recipient for an email.\n-   **Query Configuration** – Specify a condition or script that queries the selected table and filters the recipient results returned.\n\nYou can define different recipient configurations, which can be used in an email client configuration.\n\n## Procedure\n\n1.  Navigate to **Email Client** &gt; **Email Client Recipient Qualifier** and select **New**.\n\n2.  Fill in the fields at the top of the Recipient Qualifier form.\n\n    |Field|Description|\n    |-----|-----------|\n    |Name|A unique name for this email client recipient configuration.|\n    |Application|The type of scoped application.|\n    |Table|The ServiceNow table to be queried for recipients.|\n    |Description|A brief description of this recipient configuration.|\n    | | |\n\n3.  Fill in the fields in the **Display Configuration** tab to control the auto-complete display in the email client.\n\n    |Field|Description|\n    |-----|-----------|\n    |Email Address|The field on the table that contains the recipient email address.|\n    |Display Name|The field on the table used for the recipient name displayed.|\n    |Order|The order of results returned relative to other recipient qualifiers defined.|\n    |Additional Display Fields|A content list for choosing additional fields from the table to be displayed in the auto-complete list. Differentiates recipients who share the same name.|\n    |Search Additional Fields|A check box for enabling additional fields to be searched. Expands the recipients returned in the auto-complete list by querying \\(searching\\) the **Additional Display Fields**.|\n\n4.  Fill in the fields in the Query Configuration tab.\n\n<table id=\"table_l5z_lck_zfb\"><thead><tr><th>\n\nField\n\n</th><th>\n\nDescription\n\n</th></tr></thead><tbody><tr><td>\n\nPrefix Search\n\n</td><td>\n\nOption to find the desired recipient using prefix.**Note:** Selecting the **Prefix Search** option displays the **Last Name Field** drop-down menu with options to filter the recipient's name.\n\n</td></tr><tr><td>\n\nType\n\n</td><td>\n\nSelect the method for filtering the recipients returned in the auto-complete list:-   Condition\n-   Script\n\n\n</td></tr><tr><td>\n\nConditions\n\n</td><td>\n\nIf you selected Condition for the **Type**, use the condition builder to specify the conditions that must be met to return the appropriate recipients.\n\n</td></tr><tr><td>\n\nScript\n\n</td><td>\n\nIf you selected Script for the **Type**, enter a script that uses these variables to return the appropriate recipients:-   *recipientQuery*: GlideRecord for the table being queried.\n-   *targetRecord*: GlideRecord for the target record from which the email client was opened.\n For example, this recipientQuery is a GlideRecord that represents the Customer Contact table. The targetRecord variable is a Customer Service case from which the email client was opened. This query limits the email client auto-complete results to contacts who belong to the same account as the Customer Service case.\n\n```\n(function (recipientQuery, targetRecord) {\n\t\n\t // Limit results to contacts belonging to the account for the case.\n\t var account = targetRecord.getValue('account');\n\t recipientQuery.addQuery('account', account);\n\n})(recipientQuery, targetRecord);\n```\n\n</td></tr></tbody>\n</table>5.  Select **Submit**.\n\n    The recipient qualifier configuration is added to the Recipient Qualifier \\[sys\\_recipient\\_qualifier\\] table and is available for use in an email client configuration.\n\n\n**Parent Topic:**[Email client configurations](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/platform-administration/email-client-configuration.md)\n\n"}}