---
sourceDocument: Australia Enable AI
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/pt-BR/intelligent-experiences

 Release :

    - australia

ft:locale :

    - pt-BR

ft:publication_title :

    - Australia Enable AI

ft:clusterId :

    - platai

bundleId :

    - platai

workflow :

    - Platform


---

# Create an NLQ synonym

# Create an NLQ synonym {#ariaid-title1}

* Versão de lançamento: Australia
* 
* Atualizado 12 de mar. de 2026
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 2 min. de leitura

Add synonyms to improve the ability of NLQ to recognize the various ways your users request data. With synonyms, you can map commonly used words or terms to table columns.

## Antes de Iniciar

Role required: admin, nlq_admin, or pa_analyst

## Por Que e Quando Desempenhar Esta Tarefa

NLQ synonyms enable you to map common words in your users' requests to the columns in your instance tables. When these words are detected in natural-language queries, NLQ replaces them with actual column and table names, then submits the formal query.

Several synonyms are provided in the base system, and you can add more for your use cases and business requirements. Review NLQ logs of actual user utterances to find possible synonyms to add. For more information, see [View NLQ logs](https://servicenow-prod.fluidtopics.net/dMAUuvsa~WThEYCpxm2SCA "Review NLQ logs to see how the system has handled your users' plain-language requests. Use log records from attempted requests to expand NLQ synonyms or shortcuts.").

You can create a new synonym, or modify an existing synonym, as follows.

* If any synonym already exists for your target table and column, you must add your new synonym to the current record. Separate multiple synonyms with a comma.
* Synonyms can point to reference fields, using dot-walking. For more information, see [Dot-walking examples](https://www.servicenow.com/docs/access?context=dot-walking-examples&version=australia&pubname=australia-platform-user-interface&ft:locale=en-US).
* Synonyms are case-insensitive in queries.
* Synonyms can contain apostrophes and periods, but not commas.
* Synonym records are associated to one table. You can use the same synonym term for more than one table, but you must create a record for each table.
{#create-nlq-synonym__ul_z5r_zny_m1c}

## Procedimento

1. Ensure that you are in the application scope you want for your synonym, then navigate to AllNLQSynonyms.
2. Select New.  
   If you are updating an existing record, select its Column name in the list.
3. On the form, fill in the fields.  
   {#create-nlq-synonym__table_yvv_mjw_h5b__entry__2}

   | Field | Description |
   |-|-|
   | Synonym Type | Type of synonym. * Table or Column: Synonym for a value on a table or a specific column in that table. * Record: Synonym for a value on the CMDB tables \[cmdb_rel_type_table\]. For more information, see [Querying the CMDB](https://www.servicenow.com/docs/access?context=querying-cmdb&version=australia&pubname=australia-servicenow-platform&ft:locale=en-US). Nota: Supports cmdb_rel_type,cmdb_group, cmdb_ci_service_technical, cmdb_ci_service_discovered, cmdb_ci_query_based_service tables. {#create-nlq-synonym__ul_krw_tjw_h5b} |
   | Application | \[Read only\] Application scope that can use the synonym in a query. The default is Global. When creating a synonym, ensure that you are in the scope you want for the synonym. |
   | Table | Source table. You can use the same term for more than one table, but you must create a synonym record for each table. The synonym's mapping is unique to the table. |
   | Column name | Specific column on the source table. |
   | Language | Language of the synonym. Should match the language of the source value. |
   | Synonyms | Words or short phrases that the system should map to column names or tables, when converting the utterance to a formal query. Separate multiple synonyms with a comma. |
   | Extend to All Child Tables | Table or Column type only. Select this option to make any child tables of the source table inherit the synonyms. |
   [ ]

   {#create-nlq-synonym__table_yvv_mjw_h5b}
4. Select Submit if new, or Update if you are modifying an existing record.
{#create-nlq-synonym__steps_kl3_jjw_h5b}

## Resultado

The new synonym is available to your users as soon as they refresh the browser window of the list.

## NLQ Synonym for the Active field {#create-nlq-synonym__example_gd1_nlw_h5b}

The following image shows an example of an NLQ synonym record for the Active field on a change request. The synonyms open and in progress are replaced by the term
active when the system submits a query.

With this synonym record, a user can type <kbd class="ph userinput">show open change requests</kbd> or <kbd class="ph userinput">change requests in progress</kbd>and the system displays active change requests.
**Tarefas relacionadas**   

* [Create an NLQ shortcut](https://servicenow-prod.fluidtopics.net/kZfpTKUKWZAOudMwOJFZrg "Create a semantic shortcut to help improve the ability of NLQ to recognize the various ways your users request data. Semantic shortcuts operate similarly to NLQ synonyms by mapping common words to columns, but for a selected table when certain conditions are met.")
* [View NLQ logs](https://servicenow-prod.fluidtopics.net/dMAUuvsa~WThEYCpxm2SCA "Review NLQ logs to see how the system has handled your users' plain-language requests. Use log records from attempted requests to expand NLQ synonyms or shortcuts.")
* [View NLQ Table Guesser logs](https://servicenow-prod.fluidtopics.net/opNkMMTi0uQuLlal8m7LJw "Use the Table Guesser logs to review the CMDB tables that were picked by NLQ in response to plain-language queries.")