<h2>Create an assignment data lookup rule</h2><br/><div style="overflow-x:auto"> <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en"><head><meta content="text/html; charset=UTF-8" /><meta name="copyright" content="(C) Copyright 2025" /><meta name="DC.rights.owner" content="(C) Copyright 2025" /><meta name="generator" content="DITA-OT" /><meta name="DC.type" content="task" /><meta name="DC.title" content="Create an assignment data lookup rule" /><meta name="abstract" content="Automatically assign a record using Data Lookup and Record Matching." /><meta name="description" content="Automatically assign a record using Data Lookup and Record Matching." /><meta name="DC.subject" content="Task Table, data lookup rules" /><meta name="keywords" content="Task Table, data lookup rules" /><meta name="DC.relation" scheme="URI" content="../../../administer/task-table/concept/c_DefineAssignmentRules.html" /><meta name="DC.relation" scheme="URI" content="../../../administer/general/concept/intro-now-platform-landing.html" /><meta name="DC.relation" scheme="URI" content="../../../administer/general/concept/config-now-platform-core-features.html" /><meta name="DC.relation" scheme="URI" content="../../../administer/general/concept/tables-fields-and-forms.html" /><meta name="DC.relation" scheme="URI" content="../../../administer/task-table/concept/c_TaskTable.html" /><meta name="DC.relation" scheme="URI" content="../../../administer/task-table/concept/c_AssignmentRulesModule.html" /><meta name="DC.relation" scheme="URI" content="../../../administer/task-table/concept/c_DataLookupRules.html" /><meta name="DC.relation" scheme="URI" content="../../../administer/task-table/concept/c_PrecBetweenAssignmentAndBusRules.html" /><meta name="DC.relation" scheme="URI" content="../../../administer/task-table/concept/c_WorkflowAssignments.html" /><meta name="DC.relation" scheme="URI" content="../../../administer/task-table/reference/r_BaselineAssignmentRulesExample.html" /><meta name="DC.relation" scheme="URI" content="../../../administer/task-table/task/t_AssignmentModuleRule.html" /><meta name="DC.creator" content="ServiceNow" /><meta name="DC.date.created" content="2023-08-03" /><meta name="DC.date.modified" content="2023-08-03" /><meta name="DC.format" content="XHTML" /><meta name="DC.identifier" content="t_DataLookupRule" /><link rel="stylesheet" type="text/css" href="../../../CSS/commonltr.css" /><title>Create an assignment data lookup rule</title></head><body id="t_DataLookupRule"> <div class="breadcrumb"><a class="link" href="../../../administer/general/concept/intro-now-platform-landing.html" title="As a platform administrator, you have the power of the Now Platform at your fingertips. The Now Platform is an application platform as a service that automates business processes across the enterprise.">Administer the Now Platform</a> > <a class="link" href="../../../administer/general/concept/config-now-platform-core-features.html" title="The Now Platform provides for a multitude of customization options to your applications. Customize your UI, handle user and data administration, and localize your instance for time zones, currencies, and more.">Configure Now Platform Core Features</a> > <a class="link" href="../../../administer/general/concept/tables-fields-and-forms.html" title="ServiceNow provides options for managing your data on the Now Platform as well as with external data sources and applications.">Now Platform tables and data</a> > <a class="link" href="../../../administer/task-table/concept/c_TaskTable.html" title="Task [task] is one of the core tables provided with the base system.">Using the Task table</a> > </div> <h1 class="title topictitle1" id="ariaid-title1">Create an assignment data lookup rule</h1> <div class="body taskbody"><p class="shortdesc">Automatically assign a record using Data Lookup and Record Matching.</p> <div class="section prereq p" id="t_DataLookupRule__prereq_b5c_1yk_kyb"> <p class="p">Role required: assignment_rule_admin or admin</p> </div> <ol class="ol steps"><li class="li step stepexpand"> <span class="ph cmd">Navigate to <span class="ph menucascade"><span class="ph uicontrol">All</span> > <span class="ph uicontrol">System Policy</span> > <span class="ph uicontrol">Rules</span> > <span class="ph uicontrol">Assignment Lookup Rules</span></span>.</span> </li><li class="li step stepexpand"> <span class="ph cmd">Select <span class="ph uicontrol">New</span>.</span> </li><li class="li step stepexpand"> <span class="ph cmd">On the form, fill in the fields.</span> <div class="itemgroup info"> <div class="p"> <div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="t_DataLookupRule__table_wcv_gqh_fq" class="table" frame="border" border="1" rules="all"><caption><span class="tablecap"><span class="table--title-label">Table 1. </span>Assignment Data Lookup fields</span></caption><colgroup><col /><col /></colgroup><thead class="thead" style="text-align:left;"><tr class="row"><th class="entry cellrowborder" style="vertical-align:top;" id="d413212e104">Field</th><th class="entry cellrowborder" style="vertical-align:top;" id="d413212e107">Description</th></tr></thead><tbody class="tbody"><tr class="row"><td class="entry cellrowborder" style="vertical-align:top;" headers="d413212e104 ">Category</td><td class="entry cellrowborder" style="vertical-align:top;" headers="d413212e107 ">The category the data lookup matches against.</td></tr><tr class="row"><td class="entry cellrowborder" style="vertical-align:top;" headers="d413212e104 ">Subcategory</td><td class="entry cellrowborder" style="vertical-align:top;" headers="d413212e107 ">The subcategory the data lookup matches against.</td></tr><tr class="row"><td class="entry cellrowborder" style="vertical-align:top;" headers="d413212e104 ">Configuration item</td><td class="entry cellrowborder" style="vertical-align:top;" headers="d413212e107 ">The configuration item the data lookup matches against.</td></tr><tr class="row"><td class="entry cellrowborder" style="vertical-align:top;" headers="d413212e104 ">Location</td><td class="entry cellrowborder" style="vertical-align:top;" headers="d413212e107 ">The location the data lookup matches against.</td></tr><tr class="row"><td class="entry cellrowborder" style="vertical-align:top;" headers="d413212e104 ">Assignment group</td><td class="entry cellrowborder" style="vertical-align:top;" headers="d413212e107 ">The assignment group to assign the incident to.</td></tr><tr class="row"><td class="entry cellrowborder" style="vertical-align:top;" headers="d413212e104 ">Assigned to</td><td class="entry cellrowborder" style="vertical-align:top;" headers="d413212e107 ">The user to assign the incident to.</td></tr><tr class="row"><td class="entry cellrowborder" style="vertical-align:top;" headers="d413212e104 ">Active</td><td class="entry cellrowborder" style="vertical-align:top;" headers="d413212e107 ">Option to run the rule or deactivate the rule.</td></tr><tr class="row"><td class="entry cellrowborder" style="vertical-align:top;" headers="d413212e104 ">Order</td><td class="entry cellrowborder" style="vertical-align:top;" headers="d413212e107 ">Order in which the rule runs compared to other rules on the same table. The Data Lookup Plugin runs the rule with the lowest order and matching values.</td></tr></tbody></table> </div> </div> </div> </li><li class="li step stepexpand"> <span class="ph cmd">Select <span class="ph uicontrol">Submit</span>.</span> </li></ol> <div class="section result" id="t_DataLookupRule__result_dyr_vzk_kyb"> <p class="p">The rule assigns incidents to the values in the <span class="keyword option">Assignment Group</span> and <span class="keyword option">Assigned To</span> fields based on the values selected in the <span class="ph uicontrol">Category</span>, <span class="ph uicontrol">Subcategory</span>, <span class="ph uicontrol">Configuration Item</span>, or <span class="ph uicontrol">Location</span> fields. A valid assignment lookup rule requires at least one matcher field and one setter field.</p> </div> <div class="example" id="t_DataLookupRule__example_pf3_lxk_kyb"><h2 class="title sectiontitle">Assignment Data Lookup</h2>In this example, the Assignment Data Lookup rule automatically assigns any incident with the Category of Inquiry/Help and Subcategory of Email to Fred Luddy.<div class="p"><div class="fig fignone" id="t_DataLookupRule__fig_nmp_rxk_kyb"><span class="figcap"><span class="fig--title-label">Figure 1. </span>Assignment data lookup</span> <img class="image" id="t_DataLookupRule__image_omp_rxk_kyb" src="../image/Assignment_Data_Lookup.png" alt="Assignment data lookup" /> </div> </div> </div> </div> <div class="related-links"> <div class="familylinks"> <div class="parentlink"><strong>Parent Topic:</strong> <a class="link" href="../../../administer/task-table/concept/c_DefineAssignmentRules.html" title="The instance can automatically assign a task to a user or group based on pre-defined conditions by using data lookup rules and assignment rules.">Define assignment rules</a></div> </div> <div class="linklist relinfo relconcepts"><strong>Related concepts</strong><br /> <ul class="linklist"><li class="linklist"><a class="link" href="../../../administer/task-table/concept/c_AssignmentRulesModule.html" title="The Assignment rules module allows you to automatically set a value in the assigned_to and assignment_group fields when a set of conditions occurs.">Assignment rules module</a></li><li class="linklist"><a class="link" href="../../../administer/task-table/concept/c_DataLookupRules.html" title="Data lookup rules offer a generic way to change any field value, not just assignment fields.">Data lookup rules</a></li><li class="linklist"><a class="link" href="../../../administer/task-table/concept/c_PrecBetweenAssignmentAndBusRules.html" title="Scripts, assignment rules, business rules, workflows, escalations, and engines all take effect in relation to a database operation, such as insert or update. In many cases, the order of these events is important.">Precedence between data lookup, assignment, and business rules</a></li><li class="linklist"><a class="link" href="../../../administer/task-table/concept/c_WorkflowAssignments.html" title="An alternative to creating data lookup or assignment rules is to create one or more workflow tasks that assign a task record as part of a workflow.">Workflow assignments</a></li></ul></div> <div class="linklist relinfo reltasks"><strong>Related tasks</strong><br /> <ul class="linklist"><li class="linklist"><a class="link" href="../../../administer/task-table/task/t_AssignmentModuleRule.html" title="Automatically assign a record according to one or more conditions in an assignment rule. Assignment rules are designed to run at the time you open a record.">Create an assignment rule</a></li></ul></div> <div class="linklist relinfo relref"><strong>Related reference</strong><br /> <ul class="linklist"><li class="linklist"><a class="link" href="../../../administer/task-table/reference/r_BaselineAssignmentRulesExample.html" title="A baseline instance contains certain assignment rules.">Baseline assignment rules example</a></li></ul></div> </div></body></html></div>