Deploy the ServiceNow Add-in for Microsoft Outlook
Deploy the ServiceNow add-in for Microsoft Outlook so that users can chat with a virtual agent and create incidents and Visual Task Board (VTB) tasks from within Outlook.
Before you begin
Office 365 administrator access and one of the following roles on the ServiceNow instance are required to deploy the ServiceNow add-in.
Role required: sn_outlook_addin.outlook_addin_setup or admin
About this task
Deploy the ServiceNow add-in to Microsoft Outlook using the instructions in this Microsoft article: Publish Office Add-ins using Centralized Deployment via the Office 365 admin center.
Note: You must be an Office365 administrator to deploy the ServiceNow add-in.
The ServiceNow add-in is supported only for use with Outlook for Mac and Outlook for Windows (Requirement set 1.4).
You can add or remove fields directly on the Incident form for users with the itil role by customizing the Outlook view form layout. For users who don't have the itil role, you can configure a Service Catalog record producer to use for creating new incidents.
Procedure
-
Navigate to All > ServiceNow Add-Ins for Office > Office Add-In Manifests.
-
Select New on the Office Manifests page.
-
On the form, fill in the fields.
Field Description Add-in Name Display name for the add-in. For example, if the add-in needs to be deployed only for administrators, you can choose to name it accordingly. Description A short description of the add-in. For example, if the add-in is for a help desk, you can write a short description accordingly. Plugin ID A unique identification string for the add-in you are deploying. You can change the plugin ID value to a new UUID to allow usage of multiple instances of the add-in. Version Version of the plugin execution. Icon URL HTTPS URL or relative URL for ServiceNow icon to display in Microsoft Outlook. Active Option for making the add-in active. -
Select Submit.
Note: The Office Controls related list shows the menu and menu items associated with the add-in.
-
Select Download Manifest to download the add-in manifest file and follow the deployment instructions in the Microsoft article Publish Office Add-ins using Centralized Deployment via the Office 365 admin center.
-
Customize the add-in by selecting Clone Manifest from the context menu.
This option clones the current manifest into a new record that allows customizing the labels, icons, menus, and menu items.
-
To customize the Incident form for users with the itil role, configure the Incident form layout directly.
-
Select the additional actions icon [Omitted image "outlook-context-menu.png"] Alt text: on the form and select View > Outlook.
-
Select the additional actions icon [Omitted image "outlook-context-menu.png"] Alt text: on the form again and then select Configure > Form Layout.
-
Add or remove fields, as needed.
-
-
To customize the Incident form for users who don't have the itil role, use a Service Catalog record producer to configure the Incident form.
-
Navigate to Service Catalog > Record Producers.
-
Select the additional actions icon [Omitted image "additional-actions.png"] Alt text: and then select Copy sys_id.
-
Paste the copied sys_id into the Value field of the Provide sys_id of the record producer for create incident action from Outlook Add-In (sn_outlook_addin.create_incident_cat_item) system property.
-
Parent Topic:Configuring Microsoft Outlook to create incidents and VTB tasks
---
title: Deploy the ServiceNow Add-in for Microsoft Outlook
description: Deploy the ServiceNow add-in for Microsoft Outlook so that users can chat with a virtual agent and create incidents and Visual Task Board \(VTB\) tasks from within Outlook.
locale: en-US
canonical_url: https://www.servicenow.com/docs/r/it-service-management/incident-management/deploy-outlook-add-in.html
release: brazil
product: Incident Management
classification: incident-management
topic_type: task
last_updated: "2026-09-10"
reading_time_minutes: 2
breadcrumb: [Configuring Microsoft Outlook to create incidents and VTB tasks, Configuring Incident Management, Incident Management, IT Service Management]
---
# Deploy the ServiceNow Add-in for Microsoft Outlook
Deploy the ServiceNow add-in for Microsoft Outlook so that users can chat with a virtual agent and create incidents and Visual Task Board \(VTB\) tasks from within Outlook.
## Before you begin
Office 365 administrator access and one of the following roles on the ServiceNow instance are required to deploy the ServiceNow add-in.
Role required: sn\_outlook\_addin.outlook\_addin\_setup or admin
## About this task
Deploy the ServiceNow add-in to Microsoft Outlook using the instructions in this Microsoft article: [Publish Office Add-ins using Centralized Deployment via the Office 365 admin center](https://docs.microsoft.com/en-us/office/dev/add-ins/publish/centralized-deployment).
**Note:** You must be an Office365 administrator to deploy the ServiceNow add-in.
The ServiceNow add-in is supported only for use with Outlook for Mac and Outlook for Windows \(Requirement set 1.4\).
You can add or remove fields directly on the Incident form for users with the itil role by customizing the Outlook view form layout. For users who don't have the itil role, you can configure a Service Catalog record producer to use for creating new incidents.
## Procedure
1. Navigate to **All** > **ServiceNow Add-Ins for Office** > **Office Add-In Manifests**.
2. Select **New** on the **Office Manifests** page.
3. On the form, fill in the fields.
|Field|Description|
|-----|-----------|
|Add-in Name|Display name for the add-in. For example, if the add-in needs to be deployed only for administrators, you can choose to name it accordingly.|
|Description|A short description of the add-in. For example, if the add-in is for a help desk, you can write a short description accordingly.|
|Plugin ID|A unique identification string for the add-in you are deploying. You can change the plugin ID value to a new UUID to allow usage of multiple instances of the add-in.|
|Version|Version of the plugin execution.|
|Icon URL|HTTPS URL or relative URL for ServiceNow icon to display in Microsoft Outlook.|
|Active|Option for making the add-in active.|
4. Select **Submit**.
**Note:** The Office Controls related list shows the menu and menu items associated with the add-in.
5. Select **Download Manifest** to download the add-in manifest file and follow the deployment instructions in the Microsoft article [Publish Office Add-ins using Centralized Deployment via the Office 365 admin center](https://docs.microsoft.com/en-us/office/dev/add-ins/publish/centralized-deployment).
6. Customize the add-in by selecting **Clone Manifest** from the context menu.
This option clones the current manifest into a new record that allows customizing the labels, icons, menus, and menu items.
7. To customize the Incident form for users with the itil role, configure the Incident form layout directly.
1. Select the additional actions icon \[Omitted image "outlook-context-menu.png"\] Alt text: on the form and select **View** > **Outlook**.
2. Select the additional actions icon \[Omitted image "outlook-context-menu.png"\] Alt text: on the form again and then select **Configure** > **Form Layout**.
3. Add or remove fields, as needed.
8. To customize the Incident form for users who don't have the itil role, use a Service Catalog record producer to configure the Incident form.
1. Navigate to **Service Catalog** > **Record Producers**.
2. Select the additional actions icon \[Omitted image "additional-actions.png"\] Alt text: and then select **Copy sys\_id**.
3. Paste the copied sys\_id into the **Value** field of the **Provide sys\_id of the record producer for create incident action from Outlook Add-In** \(**sn\_outlook\_addin.create\_incident\_cat\_item**\) system property.
**Parent Topic:**[Configuring Microsoft Outlook to create incidents and VTB tasks](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/brazil/markdown/it-service-management/incident-management/create-incident-outlook.md)
| title | Deploy the ServiceNow Add-in for Microsoft Outlook |
| description | Deploy the ServiceNow add-in for Microsoft Outlook so that users can chat with a virtual agent and create incidents and Visual Task Board \(VTB\) tasks from within Outlook. |
| locale | en-US |
| canonical_url | https://www.servicenow.com/docs/r/it-service-management/incident-management/deploy-outlook-add-in.html |
| release | brazil |
| product | Incident Management |
| classification | incident-management |
| topic_type | task |
| last_updated | 2026-09-10 |
| reading_time_minutes | 2 |
| breadcrumb | Configuring Microsoft Outlook to create incidents and VTB tasksConfiguring Incident ManagementIncident ManagementIT Service Management |