> 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. # Moveworks for Employee Center: Installation Errata This page documents known discrepancies between ServiceNow's EmployeeWorks installation documentation and actual product behavior. Use it alongside the ServiceNow docs when setting up Moveworks. ## Upload Java KeyStore Certificate Reference page: [Upload Java KeyStore certificate](https://www.servicenow.com/docs/r/employee-service-management/employee-experience-foundation/mw-upload-jks-cert.html) ### JWT certificate generation is self-service The ServiceNow documentation instructs you to contact Moveworks Support to receive an encrypted certificate. This step is no longer required. You can generate the self-signed JWT certificate yourself using Moveworks' self-service instructions: [JWT Certificate Generation Guide (Mac & Windows)](https://docs.moveworks.com/ai-assistant/ai-assistant-web-surfaces/moveworks-for-web/moveworks-for-web-installation-servicenow#jwt-certificate-generation-guide-mac--windows) ![](https://files.buildwithfern.com/moveworks.docs.buildwithfern.com/c8950c41294f928245bc1cf932c6ca79ee5b4f1bad470bdb94e91ca0ae9bec15/docs/assets/images/employeeworks-installation-errata/jks-cert-self-service.png) ### Certificate name contains a typo in the UI After uploading, the certificate record displayed in ServiceNow is named **"Moverworks JKS"** (note the extra "r"). This is a typo in the UI. ![](https://files.buildwithfern.com/moveworks.docs.buildwithfern.com/61020b528292391e41cbfdc0a8298ea9c2643ff8cd8f8d33dd98ec29fd9c0e2a/docs/assets/images/employeeworks-installation-errata/jks-typo-moverworks.png) If you search for the certificate using the name shown in the ServiceNow documentation (`moveworks.jks`), you will get zero results. To locate the record, search for **"Moveworks JKS"** instead. ![](https://files.buildwithfern.com/moveworks.docs.buildwithfern.com/e198e157c9c307a541d5c06692bf81c7786283e1d04cda1065649b087d8018c8/docs/assets/images/employeeworks-installation-errata/jks-search-zero-results.png) ### Attachment step uses a different UI label The documentation says to "Select the Attachment option." The current ServiceNow UI labels this button **"Manage Attachments"**. ![](https://files.buildwithfern.com/moveworks.docs.buildwithfern.com/167ab648597140f67655a68dd184d82b1cc7bfd0cafef7aa32de9c1adc7a5a6d/docs/assets/images/employeeworks-installation-errata/manage-attachments-ui.png) ### "Key Store Password" field is not on the Upload JKS page The documentation references a **Key Store Password** field, but this field does not appear on the Upload Java KeyStore Certificate page. To set it: 1. Open the **Signing Configuration** record. 2. Switch to **global scope**. 3. The field is labeled **"Signing Key"** in this record. ![](https://files.buildwithfern.com/moveworks.docs.buildwithfern.com/2b90da78723612486dc9f5c0bd29fa728417d4cb3ee4e25bbebd677b4dd31cb1/docs/assets/images/employeeworks-installation-errata/signing-key-1.png) ![](https://files.buildwithfern.com/moveworks.docs.buildwithfern.com/853475f8d935df56738150f80483079be5f4d9baedc96bccc73fb29965324ebe/docs/assets/images/employeeworks-installation-errata/signing-key-2.png) ![](https://files.buildwithfern.com/moveworks.docs.buildwithfern.com/33855d3903f96e2e41eed657e18666a6ed71c51e483e8d75992bdb04c5374fb5/docs/assets/images/employeeworks-installation-errata/signing-key-3.png) ![](https://files.buildwithfern.com/moveworks.docs.buildwithfern.com/715bcd6a67e56e4e78c84789dccd445108f67cc316410c3a81e98fada6068fc0/docs/assets/images/employeeworks-installation-errata/signing-key-4.png) *** ## Configure Bot ID and AI Assistant Reference page: [Configure bot ID and AI assistant](https://www.servicenow.com/docs/r/employee-service-management/employee-experience-foundation/mw-setup-botid.html) ### Initialization options JSON field is optional The documentation describes a field labeled **"Specify the initialization options in JSON format for Moveworks integration"** without clarifying its purpose or whether it is required. This field is **optional**. You only need to populate it if you want to customize specific initialization parameters. ![](https://files.buildwithfern.com/moveworks.docs.buildwithfern.com/c65f4fb825f47056c6593de445c0064439a85bf635d36e67fbf8b50378c18fb9/docs/assets/images/employeeworks-installation-errata/botid-json-options.png) ![](https://files.buildwithfern.com/moveworks.docs.buildwithfern.com/2b6beaf65de68b104703f2847be4cbb8aca90b76e8b8d54cb6a68697ba2d0139/docs/assets/images/employeeworks-installation-errata/botid-json-example-ux.png) ### Correct scope name for saving the Bot ID record The documentation instructs you to switch to the scope **"Moveworks Chat Integration"** before saving the Bot ID configuration. This scope does not exist. The correct scope name is **"Moveworks for Employee Center"**. If you attempt to save while in the wrong scope, the record will not save and no error is displayed. ![](https://files.buildwithfern.com/moveworks.docs.buildwithfern.com/73bf9491164de37d60312fb8a9489525f036748e62b4093afd6331cdbb4956f4/docs/assets/images/employeeworks-installation-errata/botid-scope-wrong-1.png) ![](https://files.buildwithfern.com/moveworks.docs.buildwithfern.com/3e5c22f594fcfeb2fead6a497bd73dea770a7088b520751d30ff75681993a881/docs/assets/images/employeeworks-installation-errata/botid-scope-wrong-2.png) ![](https://files.buildwithfern.com/moveworks.docs.buildwithfern.com/473101ab30ec67e40ecb374a2057b2d35b042334b89bbb2db4774555f0384569/docs/assets/images/employeeworks-installation-errata/botid-scope-wrong-3.png) ## Partner-Specific ServiceNow Updates Finally, partner instances are in a different region than production instances. This means partners will need to update their ServiceNow EmployeeCenter instance to point to the appropriate region. **Instructions** 1. Navigate to your ServiceNow instance. 2. Open System Properties 3. Search for `sn_ex_mw_chat_int.webchat.initialization_options` and open it for editing 4. You should see a screen similar to the following: ![](https://files.buildwithfern.com/moveworks.docs.buildwithfern.com/bc2f6dd69593c0157fb6be4b90d41a4903f693bf58ee4f0d0bc7f8fe2908f72e/docs/assets/images/employeeworks-installation-errata/instructions-update-serverUrl.png) 5. At the bottom of the edit screen, update the Value field to: `{"serverUrl": "https://webchat.prod3.us.moveworks.com"}` 6. Save the properties changes