> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.moveworks.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.moveworks.com/_mcp/server.

# Lab 3 Pre-Requisite: Installing the Moveworks Update Sets into ServiceNow

## Overview

* **Learning Objectives:** Understand how to install the required Moveworks Update Sets into the ServiceNow instance.
* **Estimated Time:** 10 minutes
* **Prerequisites:**
  * Access to the ServiceNow PDI instance
  * The [XML versions of the Moveworks Update Sets](https://docs.moveworks.com/service-management/access-requirements/update-set-modules/servicenow-update-sets)

***

## 🛠️ 1: Walkthrough

1. Download each of the [Update Sets from the Moveworks Doc Site](https://docs.moveworks.com/service-management/access-requirements/update-set-modules/servicenow-update-sets)

![](https://files.buildwithfern.com/moveworks.docs.buildwithfern.com/ff90a98a02cb9fe392b2f16f92ee94a69bbfcec0605f9005f18717d696a19d1a/docs/assets/images/setup-labs/prereq_update_sets_download_1.png)
![](https://files.buildwithfern.com/moveworks.docs.buildwithfern.com/79d96f20009b4af7bb682e7c6542775352257e52fa2a0ee23295c59841699625/docs/assets/images/setup-labs/prereq_update_sets_download_2.png)

2. Navigate to the **`Retrieved Update Sets`** page within ServiceNow

![](https://files.buildwithfern.com/moveworks.docs.buildwithfern.com/2a88508f4b56ff36d005b7df4c4ed1975976c056d75039ae968fb45bf2f2060b/docs/assets/images/setup-labs/prereq_retrieved_update_sets.png)

3. Click **`Import Update Sets from XML`** at the bottom of the page

![](https://files.buildwithfern.com/moveworks.docs.buildwithfern.com/ce3ecc6865d7972b2a7483b47c3193e2abe58a9e662e9511eac9312235f14614/docs/assets/images/setup-labs/prereq_import_update_sets_from_xml.png)

4. Upload each Update Set downloaded in Step 1

![](https://files.buildwithfern.com/moveworks.docs.buildwithfern.com/e0e6a06523fa84ef0cc27150c7e2e714ef9f4d97d12a589857bcdc208cc5bcf6/docs/assets/images/setup-labs/prereq_choose_update_set.png)

**Commit the base Update Set (`moveworks.base`) before committing any of the others.** The remaining Update Sets depend on it — committing them out of order will result in errors.

5. After uploading the Update Sets, **`Preview`** and **`Commit`** each one to activate them in your ServiceNow instance

![](https://files.buildwithfern.com/moveworks.docs.buildwithfern.com/ed758d8a0fc802cf07932951bb25d26835c47d8f251ef5bb0d2e6d911e54bae8/docs/assets/images/setup-labs/prereq_update_set_preview.png)
![](https://files.buildwithfern.com/moveworks.docs.buildwithfern.com/a4fa12137f47182ff8b45c8bfd57bdd5e6bc4a8acf216d1a0617897f5dca9bc5/docs/assets/images/setup-labs/prereq_update_set_commit.png)

6. Confirm that all required Update Sets have been installed

Depending on the purpose of this lab, you may not need to install the HR or AWA Handoff Update Sets. Your instructor will let you know which ones are required.

![](https://files.buildwithfern.com/moveworks.docs.buildwithfern.com/4b8b8ca962757a91996445bc6589ed8053b02c4834c5f6c56e19c0e540d88a2d/docs/assets/images/setup-labs/prereq_all_update_sets.png)

7. Navigate to **`Organization > Users`** and select the admin account you are using as your Moveworks Service Account user

![](https://files.buildwithfern.com/moveworks.docs.buildwithfern.com/f6a96d07bd44f3012fb593b178bb1fafa1b93caca228e6a4a536574a41ee88f6/docs/assets/images/setup-labs/prereq_user_navigation.png)
![](https://files.buildwithfern.com/moveworks.docs.buildwithfern.com/4d80389f5916a05d5a46d74794d723e29e01cc41b3df39c9d4e30345119d0a44/docs/assets/images/setup-labs/prereq_now_select_admin.png)

8. Assign the **`moveworks_user`** role and **`Save`** the update

## ![](https://files.buildwithfern.com/moveworks.docs.buildwithfern.com/751153a7c963b02f95d676a3f0db01b6ee7510150127da9914c7d7a21834dc38/docs/assets/images/setup-labs/prereq_now_select_roles.png)

## ✅ 2: Verification & Next Steps

1. **Finalize:**
   1. Ensure all Update Sets are marked **`Committed`**
   2. Ensure that your Moveworks Service Account user has the **`moveworks_user`** role saved

**Next:** [Lab #3 — Enterprise Search](/ai-assistant/getting-started/labs/moveworks-setup/lab-3-configuring-enterprise-search-de072ea4565053c4) — configure Moveworks to ingest and search the ServiceNow knowledge articles your update sets just enabled.

***

## 🪞 3: Reflecting on This Configuration

Through this guide, you've learned the following:

* Where to find the Moveworks ↔ ServiceNow Update Sets
* How to install them into a ServiceNow instance
* How to apply the **`moveworks_user`** role to the ServiceNow service account used for the Moveworks integration

***

## ⚙️ 4: Configuration Details

| **Field Name**            | **Action / Value to Enter**                                                                                                                            |
| ------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Retrieved Update Sets** | Install `moveworks.base` and `moveworks.acl`. If doing the Advanced Ticketing or Live Agent Message Brokering labs, also add the HR & AWA Update Sets. |
| **Service Account Role**  | `moveworks_user`                                                                                                                                       |