*** title: 'AI Assistant on Web: Configuration ' position: 2 excerpt: >- This section covers steps you can take to give your entire organziation access to assistant on web and preferences you can set for your brand. deprecated: false hidden: false metadata: robots: index ------------- ## **Overview** Assistant on Web uses your organization’s existing **My Moveworks SSO setup** to determine who can access the experience. If your company already uses My Moveworks, anyone who has been assigned that app through your SSO provider (ex. Okta) will automatically have access to Assistant on Web. > Note: The “My Moveworks” app name and subdomain (e.g. `m8.moveworks.com`) may differ depending on how your organization configured the SSO given that both are configurable. In most cases, customers have kept the name “My Moveworks” as their app name and are using the name of their company, “org\_name”, as the subdomain (`org_name.moveworks.com/assistant`) > > This is also a good opportunity to consider changing the name of your "My Moveworks" app within your SSO setup given that all your employees will find this application within their SSO landing page. We recommend renaming the "My Moveworks" app to your bot name (ex. If your bot name is "Shelly" then replace the name "My Moveworks" to "Shelly" so your employees can easily find the application. ## What is my login URL to My Moveworks? Your org's login URL is dependent on your region. Replace `org_name` with the name of your Moveworks org name. | Data Center | Login URL | | :----------------------- | :------------------------------------------------------------------------------------------------ | | United States (default) | [https://org\_name.moveworks.com](https://org_name.moveworks.com) | | Canada | [https://org\_name.am-ca-central.moveworks.com](https://org_name.am-ca-central.moveworks.com) | | EU | [https://org\_name.am-eu-central.moveworks.com](https://org_name.am-eu-central.moveworks.com) | | Australia / Asia Pacific | [https://org\_name.am-ap-southeast.moveworks.com](https://org_name.am-ap-southeast.moveworks.com) | | Government Secure Cloud | [https://org\_name.moveworksgov.com](https://org_name.moveworksgov.com) | ## Steps to verify if you have access to Assistant on Web To verify if you have access to your My Moveworks app **try accessing Assistant on Web.** You can access the Assistant on Web experience in several ways: 1. **Via your My Moveworks landing page** Go to your organization’s My Moveworks URL (for example, `org_name.moveworks.com`). You’ll automatically be redirected to the Assistant experience at: `org_name.moveworks.com/assistant` ℹ️ Note: As part of the Assistant on Web launch, the default landing page experience has changed. Previously, this URL opened the My Moveworks stakeholder experience (a page that displayed entry points to your stakeholder applications like Agent Studio). We’ve intentionally updated this behavior so that all users now land directly in the Assistant experience, reflecting our focus on making the AI Assistant the central hub of work. Stakeholder applications remain accessible from new landing assistant page, via “Manage Apps” within the left nav. ![](https://files.readme.io/947646b5a0184baf92ae837c8c3d78796d27d405f4c2304691d62ad13d60f56c-image.png)
2. **Direct URL access** You can also go directly to your Assistant on Web URL: `https://www.org_name.moveworks.com/assistant` 3. **Through your company’s SSO dashboard** If your organization uses Okta, Entra (Azure AD), OneLogin, or Google Workspace, you can find and launch the app directly from your SSO dashboard (ex. at Moveworks since we use Okta our SSO dashboard is `moveworks.okta.com`). **If you don't have access or want to add additional users please coordinate with your IT or Identity team** * You'll need to identify who in your organization manages **Identity and Access Management (IAM)** or **SSO provisioning** (for example, your **IT Admin** or **ITAM**). If you’re unsure who owns this process, start by checking with your IT or HR systems team. * You’ll need their help to confirm user assignments and make updates in your SSO provider (e.g., Okta, Microsoft Entra, OneLogin, Google Workspace). ## **Who has access to Assistant on Web?** Access to Assistant on Web is determined by your organization’s SSO provisioning rules. Make sure all employees who should have access to the Assistant on Web have been **provisioned the “My Moveworks” app** (or your organization’s equivalent app name) through your SSO provider. Moveworks has no visibility into who within your organization has currently been provisioned your My Moveworks application given that the information lives within your SSO provider. * Only provisioned users will be able to sign in once the Assistant on Web experience. In most cases at this moment only employees within your organization who have access to a stakeholder application (ex. Agent Studio) have currently been provisioned the "My Moveworks" app within your SSO provider. * Any employee who has been assigned your organization’s *My Moveworks* app (or its equivalent name) through your identity provider (IdP) can sign in to Assistant on Web. ## **Rolling out Assistant on Web to all your employees** When you are ready to enable this new platform for all our your employees, you'll need to coordinate this change with your IT or Identity team. \*\*Who do I assign the My Moveworks app to? \*\* * You'll want to assign the My Moveworks application to the same users who currently have access to your assistant on your chat platforms (ex. Slack/ Microsoft Teams). * Access to assistant on web is limited to the same set of users who currently have access to the AI Assistant through your chat platforms (e.g., Slack or Microsoft Teams). * Only users with a valid AI Assistant user license can start using the Assistant. **When I assign the My Moveworks app to my entire organization do I need to change any settings on the Moveworks Setup "Roles and permissions" page?** * No, you will not need to make any changes on the "Roles and permissions" page. If you want to grant them access to one of your stakeholder applications, then you will need to make this change on your "Roles and permissions" page. * By default the new users that are being provisioned the "My Moveworks" application within your SSO application **will not have access to any of your stakeholder applications** unless you'd like them to. * While the new users will not able to access your stakeholder applications, they will be able to access the `/manage` webpage (ex. `https://www.org_name.moveworks.com/manage`[]()) . This webpage does contain web links to Community and Moveworks Academy. We are making a future improvement so that in the future only users with access to stakeholder applications can access to `/manage` webpage. This is what users who don't have access to any stakeholder applications will see. * ![](https://files.readme.io/30ab29c7cd88bd7d1b6133d47a8f9e1b76e27e2e43c43c27d2c57638e4572076-image.png) **What happens if an employee gets provisioned the My Moveworks application but does not have a user license to use assistant (ex. they don't currently have access to assistant on a chat platform)?** ![](https://files.readme.io/a3b76e2012be2510f004e2a776cf773a7628a7dd3d7b40937299a36d9daa15c3-image.png) * If an unlicensed user logs in, they’ll be able to access the experience but will be unable to chat with your AI Assistant. Assistant will say something like, "I'm sorry I'm unable to help you with your request". ## **How can I assign the My Moveworks app to all our employees?** Assigning the app is handled within your organization’s SSO or Identity Provider (IdP) — for example, Okta. #### Tip: Completing these steps early ensures your employees can access Assistant on Web as soon as it’s available, no delays or additional setup required. This is a standard process used to control who can access enterprise applications. **Moveworks does not manage this step — it’s typically owned by your IT admin or IAM team.** > **Change Management Note** > > You may need to work with your IT administrators to ensure the *My Moveworks* app (or your custom Moveworks app name) is assigned to all employees who should have access to the Assistant on Web experience. To learn how to assign users to an enterprise application, follow your SSO provider’s latest documentation below: | SSO Provider | Instructions | | :------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------- | | Okta | [How to assign users](https://support.okta.com/help/s/article/How-To-Assign-An-User-To-An-Application?language=en_US) | | Microsoft Entra (Azure AD) | [How to assign users](https://learn.microsoft.com/en-us/entra/identity/enterprise-apps/assign-user-or-group-access-portal?pivots=portal) | | OneLogin | [How to assign users](https://www.onelogin.com/getting-started/free-trial-plan/add-users-manually) | | Google Workspace | [How to assign users](https://support.google.com/a/answer/179832?hl=en) | | OpenID Connect (OIDC) | [How to assign users](https://learn.microsoft.com/en-us/entra/identity-platform/v2-app-types) | | SAML | [How to assign users](https://learn.microsoft.com/en-us/entra/identity/enterprise-apps/add-application-portal-setup-sso) | ## **Branding Support Configuration** Assistant on Web will automatically inherit your organization’s existing Assistant branding settings from Moveworks Setup. This help ensures a consistent experience across all platforms (ex. Slack, Teams, and Web) without requiring you to reconfigure your Assistant’s appearance. Your Assistant on Web will display the same: * Assistant image * Assistant name * Customize colors Note: The Assistant name, image, and color are configured once within Moveworks Setup and apply automatically across all surfaces. You do not need to upload a new image or re-enter these details for the web experience. Changes can be made within Moveworks Setup, but will apply to all platforms. ## Customizations Offered 1. [Assistant Image ](/ai-assistant/ai-assistant-web-surfaces/assistant-on-web-overview/configuration#1-assistant-image) *(Assistant on Web & Embedded Assistant)* 2. [Assistant Name](/ai-assistant/ai-assistant-web-surfaces/assistant-on-web-overview/configuration#2-assistant-name) *(Assistant on Web & Embedded Assistant)* 3. [Primary Color ](/ai-assistant/ai-assistant-web-surfaces/assistant-on-web-overview/configuration#3-primary-color) *(Assistant on Web & Embedded Assistant)* ![](https://files.readme.io/f546660bf1315e3e8477a9641baf6f4baa2bc5fbe913d9e11aa9b27568168343-image.png) ![](https://files.readme.io/b654f1aff4dc86984a854ce5fd9e4bceb5095963bdc98563c77c4ff1033b2a20-image.png) ### **1. Assistant Image** (Assistant on Web & Embedded Assistant) The assistant image that's for Assistant on Web and Embedded Assistant are separate configs. **Assistant on Web** Within Moveworks Setup, navigate to the following configuration page to verify the image that's being used as your assistant avatar: * Find the "Organization Details" section * Expand the "Tenant Settings" section * Click on "General Information" * Expand the "AI Assistant Preferences" section * Look at the image that appears within "AI Assistant Avatar" ![](https://files.readme.io/95f25242164077dd0d4670b25096aeeaeaddef709e21c6cbabca84d733e3d2d7-image.png) **Embedded Assistant** Within Moveworks Setup, navigate to the following configuration page to verify the image that's being used as your assistant avatar: * Find the "Organization Details" section * Click on "Tenant Settings" * Expand the "Company Details" section * Expand the "AI Assistant Preferences" section * Look at the image that appears within "`Avatar Button Image Url`" ![](https://files.readme.io/3d642f0f345941125d9af836d111ac4e36aa062ba3c0f6131a465dbec3c8c167-image.png) ### **2. Assistant Name** (Assistant on Web & Embedded Assistant) Your Assistant’s name (aka bot name) is also inherited from Moveworks Setup. > For example: If your AI Assistant is called, “Ask Maya” in Microsoft Teams, it will also appear as “Ask Maya” on Web. The assistant name appears on * The left navigation panel and * on the landing page for your AI Assistant To update your Assistant’s name across all platforms following the following steps: 1. Login to Moveworks Setup 2. On the left nav find the "Chat Platforms" section and click on "Manage Chatbots" 3. You will see all the applicable platforms you've setup. You'll need to click on "edit" for each platform and modify the `Bot Friendly Name` field. ### **3. Primary Color** (Assistant on Web & Embedded Assistant) To modify the primary color navigate to the following config within Moveworks Setup: * Find the “Chat Platform” section * Click on “Display Settings” * Expand the “Moveworks Web Forms UI Styling” section * Modify the “Web interface primary color” `Web interface primary color`: This primary color will apply to Assistant on Web and Embedded Assistant \*\*Here's how those colors are used: \*\* **Assistant on web:** ![](https://files.readme.io/9ae86d69968935b450d0183f290333be31cbf60cf0d0317dfd70014927e5ec15-image.png) `Web interface primary color:` The primary color you select is applied to the following UX elements within the Web experience: * The background color of the “new chat thread” button. * The user avatar will use a 16% opacity based on the primary color you set. * The background color for your bot image (assuming your bot image was a logo with a transparent background) ![](https://files.readme.io/430704131d3c538fbd11cb1874a5194632b2582edc6072d756173b738697de82-image.png) Here are some examples that show primary color impacts assistant logos that have transparent backgrounds. **Example 1**: The uploaded image has a white logo (our Moveworks logo) with a transparent background. ![](https://files.readme.io/5265af18e588f153c68c46f80ea64d98d7b398096745ad268bfcbc4b591a8687-image.png) **Example 2**: The uploaded image has a object (our m8 bot) with a transparent background. ![](https://files.readme.io/3313e50cee4c3dbe610abeeeed1fb0744bc18577aae1bccead5e7b94a64e369d-image.png) **Example 3**: The uploaded image has a grey solid background with an object (our m8 bot). ![](https://files.readme.io/b5f59ef7a1b8381def1169c52a99094a0af5db21184bcdcf3a21ec218b04dc19-image.png) **Reference page** No additional color customizations are offered on this page. You will notice the same visual treatment that are visible on the assistant on web experience such as the background color for the user avatar, your assistant name, and assistant logo appearing. ## Additional Customizations (Coming Soon: March 9, 2026) *:eyes: Note there's been a timeline delay given we previously communicated Feb 27, 2026.* Based on additional feedback we've been receiving from our customers, we plan to introduce additional customizations that impact our Assistant on Web, Embedded Assistant, and Reference Page. Soon you will be able to make the additional customizations outlined below: 4. [Upload A Customer Brand Logo](/ai-assistant/ai-assistant-web-surfaces/assistant-on-web-overview/configuration#4-upload-a-customer-brand-logo-assistant-on-web-only)*(Assistant on Web only)* 5. [Primary Color (Logic update) ](/ai-assistant/ai-assistant-web-surfaces/assistant-on-web-overview/configuration#6-set-a-background-app-color-assistant-on-web-embedded-assistant--reference-page)*(Embedded Assistant)* 6. [Set A Background App Color ](/ai-assistant/ai-assistant-web-surfaces/assistant-on-web-overview/configuration#6-background-app-color-assistant-on-web-embedded-assistant--reference-page) *(Assistant on Web, Embedded Assistant, Reference Page)* 7. [Set A Secondary Color ](/ai-assistant/ai-assistant-web-surfaces/assistant-on-web-overview/configuration#7-set-a-secondary-color-assistant-on-web-embedded-assistant) *(Assistant on Web, Embedded Assistant)* 8. [Select A Font Style ](/ai-assistant/ai-assistant-web-surfaces/assistant-on-web-overview/configuration#8-set-a-font-style-assistant-on-web-embedded-assistant--reference-page) *(Assistant on Web, Embedded Assistant, Reference Page)* To help you visualize these new customizations, we're using the following customization settings unless otherwise specified: ![](https://files.readme.io/d771452572da374c22587dd55c3e32582760707a7e21ea9a9ba88c630cc05c74-image.png) ### **4. Upload A Customer Brand Logo** (Assistant on Web only) We're giving you more control over your brand on Assistant on Web and allowing. you to upload your own company brand logo which will be displayed within the left navigation bar. **Customizations selected for example shown:** * Background app color: Beige (Default) * Primary color: Red * Secondary color: None (Default) **Left Navigation Bar Expanded** ![](https://files.readme.io/a5778858f2b48e38c37318fdb7182e227a9f80081cf4f9dd23a4de07176ea2dc-wrapper_14.png) **Left Navigation Bar Collapsed**\_ (Shown with the default beige background)\_ ![](https://files.readme.io/689f21b5e118542f61d6295c1ebf2b149f6abe439245e3d1b376779fc86fd30e-wrapper_15.png) *Note that our "Moveworks from ServiceNow" brand logo will stay within the experience and displayed on the right hand side of the experience.* #### Recommendations for your customer brand logo: * Image File Size: 500 KB – 1 MB, max size 1MB * File Format: PNG (Preferred)\* * Max Width / Height: 200px / 24px (Auto-scaled) *\*SVG and JPEG images will not be supported.* **Variations of the customer bot logo we will support:** * **Transparent background:** (Preferred) We’d prefer customer bot logos to include a transparent background so that the logo appears as if it’s part of the native experience. * **Logo with solid background:** If the image contains a solid colored background, then that color will be displayed within the left nav. ### 5. Primary Color Logic Update (Embedded Assistant only) Below is the logic for how we use Primary Color within our experiences:
UI Element Assistant on Web Embedded Assistant
"New Chat Thread" button The primary color fills the background color of the new chat thread button. N/A
User Avatar Circle The user avatar will use a 16% opacity based on the primary color you set. The user avatar will use a 16% opacity based on the primary color you set.
Assistant Image (Transparent backgrounds only) The primary color will fill the background of your assistant image. The primary color will fill the background of your assistant image.
"Send"/"Enter" button N/A **NEW:** The primary color will fill the background color of the "send"/"enter? button.
**UI Elements Shown Below:** ![](https://files.readme.io/703da191e75abff32a1ab395a8daca7413a9062a23b3d022298a040ba4a8069e-image.png) ### **6. Set A Background App Color** (Assistant on Web, Embedded Assistant, & Reference Page) The default out of the box Assistant should be the existing Beige UI, and customers can further customize the Assistant with the following customization options. Customer can select one of 2 options: * **Beige background**: Our signature default, thoughtfully designed to align with the core MW platform brand and style. * **White background**: A clean, versatile option designed to blend seamlessly with almost any customer brand identity. Examples shown below: **Embedded Assistant** (Customizations Variations Below) ![](https://files.readme.io/32dada8f98cdb53fdb28e09093d650d9820faf30fba0c788baa670d0ea5067e7-image.png) **Assistant on Web** ![](https://files.readme.io/269fd6f788ff67cedef278206e710f6f5e6ceb1f8ccbcdbbd6162f9c70aae490-image.png) **Reference Page** ![](https://files.readme.io/fdfc6cbcb61b2dd9d32a6a22448dd6ca2a24832a7ef663ec68f9b3f44fc49bd4-image.png) ### **7. Set A Secondary Color** (Assistant on Web, Embedded Assistant) In addition to primary color, now you'll be able to specify a secondary color. The secondary color will be used within the following UI elements across Assistant on Web and Embedded Assistant. A. Background color of the left navigation bar (Assistant on Web only) B. Outline color of the input (Assistant on Web + Embedded Assistant) C. Background color of the header (Embedded Assistant) **Customizations selected for examples below:** * Background app color: **White** * Primary color: Red * Secondary color: **Light Red** **Assistant on Web:** ![](https://files.readme.io/f6fb2c45b296107da8457db1c82474bc3cfa8b3b36ef6737878683b61838b313-wrapper_16.png) **Embedded Assistant:** ![](https://files.readme.io/b9780c173b99bb1959986e28a85cf219fe226ec61cbc172f533b371e54cb804b-image.png) ### **8. Set A Font Style** (Assistant on Web, Embedded Assistant, & Reference Page) Customers can select a font style within Moveworks Setup. You can select a font style from a list of supported font styles. The selected font style (ex. Roboto) will appear across all of our web experiences. The same font style will be used for headers and body text. We will apply a different font weight depending on whether its a header or body text. How does weights get applied to the experiences? * **Headers:** Since headers are bold by default, any new font you pick will also be **bold**. * **Body Text:** Since body text is normally regular weight, any new font you pick will stay in that **regular** weight. Examples shown below (Font style: Roboto): **Embedded Assistant** ![](https://files.readme.io/7dfa53b69fe31a6d2b184b6f69621280f390679fadafcd662bef33793e2e5e84-image.png) **Assistant on Web:** \[Image coming soon] **Reference Page:** \[Image coming soon] ## **FAQs** ### **Q: Can I change the name of “My Moveworks” app or my URL subdomain?** Yes, both the [app name and subdomain are configurable](/service-management/administration/organization-information#/how-can-i-customize-my-companys-mymoveworks-url) . You can configure the “My Moveworks” app name via your SSO provider website. The subdomain within the url can also be configured via your Moveworks Setup too if you’ve like to change it. ### **Q: What happens if a user isn’t assigned the My Moveworks app?** The user will not be able to access the website. Once the app is assigned via your SSO provider, they can sign in successfully. ### **Q: Does Assistant on Web require Enterprise Search?** No. Assistant on Web is included at no additional cost and can be used independently of Enterprise Search. ### **Q: Can I preview how my Assistant will look on Web?** Yes. Once you have access to Assistant on Web, open your organization’s URL (for example, `mycompany.moveworks.com/assistant`) to see your live branding applied. ### **Q: Can I access assistant on web on mobile devices?** Yes, however it depends on whether or not your organization has mobile access enabled for your SSO applications. If the organization's IT team has enabled mobile access for your My Moveworks app, your employees will be able to open Assistant on Web from a mobile device.