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

# Advanced Configuration Editor

The **Advanced Configuration Editor** lets you view and edit Moveworks Setup configurations directly in JSON format. Found under **Troubleshooting Tools** in the left navigation bar, this power tool puts full configuration control at your fingertips — enabling bulk operations, configuration duplication, environment migration, and faster troubleshooting.

The Advanced Configuration Editor is intended for **Moveworks partners and Advanced Moveworks users**. We do not recommend admins use this mode as it directly modifies live configurations and can break existing functionality — use the standard UI instead.

***

## Key use-cases for using advanced configuration editor

| **Capability**            | **Description**                                                                                                                      |
| ------------------------- | ------------------------------------------------------------------------------------------------------------------------------------ |
| Bulk Operations           | Upload, replace, or copy-paste multiple configurations at once — e.g., adding 150 destinations and payload mapping in one go.        |
| Configuration Duplication | Copy an entire configuration JSON from one instance or implementation and paste it into another, adjusting only org-specific fields. |
| Environment Migration     | Quickly promote configurations from sandbox to production by copying JSON and updating only environment-specific values              |
| UI Fallback               | Add or edit configurations when the standard Moveworks Setup UI has issues — e.g., bypassing an overly strict UI validation bug      |

***

## How to Use

### Step 1: Navigate to the Advanced Configuration Editor

Go to **Moveworks Setup > Troubleshooting Tools > Advanced Config Editor** in the left navigation bar.

### Step 2: Select a Configuration

1. Use the **Configuration** dropdown to search for and select the configuration you want to view or edit.
2. Configurations are identified by their Moveworks configuration name (e.g., `TicketWorkflow`, `CustomDomainConfig`, `TicketRoutingConfig`).
3. Only a subset of configurations are available. These are vetted by the Moveworks team.

| **Configuration Type** | **Behavior**                                                                                                                         |
| ---------------------- | ------------------------------------------------------------------------------------------------------------------------------------ |
| Single cardinality     | Displays a single sub-configuration directly (e.g., InfoConfig, HandoffConfig)                                                       |
| Multi-cardinality      | Displays a list of sub-configurations to choose from, plus a **• Add new config** option (e.g., TicketWorkflow with 20+ sub-configs) |

### Step 3: View and Edit the JSON

1. The full JSON configuration is displayed in the editor.
2. Make your changes directly in the JSON editor.
3. Click **Save** to submit your changes.

**On success:** You will see a confirmation message: *"Your change is now successfully saved."*

**On error:** The editor will display a specific error code and message. For example:

* **Error 13009** — Validation failure (e.g., `display_name must contain at least 1 character`)
*
* **Error 13002** — Deserialization failure (e.g., submitting empty or malformed JSON)

### Step 4: Add a New Configuration (Multi-Cardinality Only)

For multi-cardinality configurations:

1. Select the configuration type from the dropdown.
2. Click **+ Add new config**.
3. The editor opens in **create mode** with a blank JSON template containing the required fields.
4. Fill in the required fields and click **Save**.

***

## Important Guardrails

| **Guardrail**                       | **Details**                                                                                                                                                                                                                                       |
| ----------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Only Moveworks Setup configurations | Only Moveworks setup configurations are provided through this view. The configurations are sub-set and vetted by the Moveworks team as "Safe to be edited" in a JSON based view                                                                   |
| Internal fields stripped            | Any fields that are internal to Moveworks are not exposed via this view or cannot be edited                                                                                                                                                       |
| No UI validations                   | Standard UI validations (required fields, min length, etc.) are not enforced in JSON mode — use caution.                                                                                                                                          |
| No DSL hints                        | DSL validation and hints available in the standard UI are not available in JSON mode.                                                                                                                                                             |
| Bender fields                       | Bender fields (if applicable) must be added or modified in the long format. Please note the Moveworks Setup UI uses a short hand bender format. We absolutely do not recommend using the Advanced configuration editor for bender related fields. |
| No Credential visibility            | The JSON view shows a masked ID for fields where a secrets are being stored. We recommend to be extremely cautious not edit this as this might cause the connector to fail.                                                                       |

## Common Use Cases

| **Use Case**                                                | **How It Helps**                                                                                                                    |
| ----------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------- |
| Replicate a ServiceNow ticketing mapper across subsidiaries | Copy the full JSON config, paste it into a new tenant, and adjust only org-specific fields (assignment group IDs, custom field IDs) |
| Promote a Slack connector from sandbox to production        | Copy sandbox JSON, paste into production, update only environment-specific values (workspace ID, OAuth references), and validate    |
| Work around a UI validation bug blocking a go-live          | Bypass an overly strict UI validation (e.g., blocked non-US locale) by editing the JSON directly                                    |

***

## Reference list for Setup left nav page to configuration name in the dropdown

### Enterprise Search

| **Dropdown Value**         | **Setup Left-Nav Path**                                               |
| -------------------------- | --------------------------------------------------------------------- |
| `KnowledgeIngestionConfig` | Search -> Configure Search -> Classic Ingestion -> Internal Knowledge |
| `KnorahConfig`             | Lookup -> Plugin Settings                                             |
| `DisplayVarsSetup`         | Lookup -> Lookup Configs                                              |
| `KnorahConfigSetup`        | Lookup -> Conference Rooms                                            |

### Ticketing Automation

| **Dropdown Value**                                    | **Setup Left-Nav Path**                                     |
| ----------------------------------------------------- | ----------------------------------------------------------- |
| `BackfillTicketEventsConfig`                          | Ticketing -> Advanced Settings -> Ticket Event Backfill     |
| `FileTicketDestinationsConfig`                        | Ticketing -> Advanced Settings -> File Ticket Destination   |
| `FileTicketTypeOverridesConfig`                       | Ticketing -> Advanced Settings -> Overrides                 |
| `IPAllowlistConfig`                                   | Ticketing -> Advanced Settings -> IP Allowlist              |
| `ITSMProviderConfig`                                  | Ticketing -> Advanced Settings -> ITSM Providers            |
| `ITSMProviderConfig-AdvancedSettings`                 | Ticketing -> Advanced Settings -> ITSM Providers            |
| `ITSMProvidersConfig`                                 | Ticketing -> Advanced Settings -> Ticket Poller Settings    |
| `ITSMProvidersConfig-AdvancedSettings`                | Ticketing -> Advanced Settings -> Ticket Poller Settings    |
| `ITSMWebhooksConfig`                                  | Ticketing -> Advanced Settings -> Webhooks                  |
| `ServicePortalConfig`                                 | Ticketing -> Advanced Settings -> Service Portal URL        |
| `TicketDestinationConfig`                             | Ticketing -> Advanced Settings -> Ticket Destinations       |
| `TicketDestinationConfig-AdvancedSettings`            | Ticketing -> Advanced Settings -> Ticket Destinations       |
| `TicketDestinationMapper`                             | Ticketing -> Advanced Settings -> Ticket Destination Mapper |
| `TicketTypesConfig`                                   | Ticketing -> Advanced Settings -> Ticket Types and States   |
| `TicketTypesConfig-Ingestion`                         | Ticketing -> Advanced Settings -> Destination Level Mapper  |
| `ITSMProvidersConfig-Concierge`                       | Ticketing -> Concierge Settings -> Advanced Settings        |
| `TicketUpdateNotificationConfig`                      | Ticketing -> Concierge Settings -> Advanced Settings        |
| `TicketingActionConfig-AdvancedSettings`              | Ticketing -> Concierge Settings -> Advanced Settings        |
| `TicketUpdateNotificationConfig-NotificationDelivery` | Ticketing -> Concierge Settings -> Notifications Settings   |
| `NotificationScheduleConfig`                          | Ticketing -> Concierge Settings -> Notifications Settings   |
| `TicketUpdateNotificationConfig-TicketActions`        | Ticketing -> Concierge Settings -> Ticket Actions           |
| `TicketingActionConfig-TicketActions`                 | Ticketing -> Concierge Settings -> Ticket Actions           |
| `TicketFiltersConfig`                                 | Ticketing -> Ticketing Settings -> Ticket Filters           |
| `MWFormConfig`                                        | Ticketing -> Ticketing Settings -> Rich Ticket Filing       |
| `AccessAccountIntegrationConfig-Ticketing`            | Ticketing -> Ticket Interception                            |
| `AccessGroupConfig-Ticketing`                         | Ticketing -> Ticket Interception                            |
| `AccessSoftwareConfig-Ticketing`                      | Ticketing -> Ticket Interception                            |
| `TicketRoutingConfig`                                 | Ticketing -> Ticket Interception                            |
| `TicketingActionConfig-Interception`                  | Ticketing -> Ticket Interception                            |
| `NudgeConfig-Ticketing`                               | Ticketing -> Ticket Nudge Setup                             |
| `TicketRoutingConfig-Workflows`                       | Ticket Workflows -> Routing Conditions                      |
| `TicketWorkflow`                                      | Ticket Workflows                                            |
| `FormIngestionConfig`                                 | Forms -> Advanced Settings -> Plugin Settings               |
| `FormIngestionConfig-Bidding`                         | Forms -> Advanced Settings -> Plugin Settings (Bidding)     |
| `FormIngestionIntegrationConfig`                      | Forms -> Advanced Settings -> Form Ingestion Advanced Mode  |
| `FormsConfig`                                         | Forms -> Advanced Settings -> Plugin Settings               |
| `ITSMProvidersConfig-Bidding`                         | Forms -> Advanced Settings -> Plugin Settings (Bidding)     |
| `TicketingActionConfig`                               | Handoff -> Live Agent Handoff                               |
| `AgentHandoffConfig`                                  | Handoff -> Live Agent Handoff                               |
| `MessageBrokeringConfig`                              | Handoff -> Message Brokering                                |
| `HandoffConfig`                                       | Handoff -> Handoff Settings                                 |
| `ApprovalsConfig`                                     | Enterprise Approvals -> Plugin Settings                     |
| `ApprovalsResourceConfig`                             | Enterprise Approvals -> Resource Settings                   |
| `ApprovalsIntegrationConfig`                          | Enterprise Approvals -> Integration Settings                |

### Access Management

| **Dropdown Value**                | **Setup Left-Nav Path**                        |
| --------------------------------- | ---------------------------------------------- |
| `AccessAccountConfig`             | Account Access -> Advanced Settings -> Bidding |
| `AccessAccountIntegrationConfig`  | Account Access -> Plugin Settings              |
| `GroupIngestionConfig`            | Group Access -> Ingestion                      |
| `AccessGroupConfig`               | Group Access -> Connector Settings             |
| `AccessGroupConfig-SkillSettings` | Group Access -> Plugin Settings                |
| `AccessSoftwareApp`               | Software Access -> Software Catalog            |
| `AccessSoftwareConfig`            | Software Access -> Connector Settings          |
| `NamedApprovalExp`                | Moveworks Approvals -> Approval Workflows      |

### Core Platform

| **Dropdown Value**                       | **Setup Left-Nav Path**                                                                                                       |
| ---------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------- |
| `ConnectorConfig`                        | Connectors -> Built-in Connectors                                                                                             |
| `[ConnectorName]Connector`               | Connectors -> Built-in Connectors (70+ individual connectors, e.g., `SlackConnector`, `SnowConnector`, `JiraConnector`, etc.) |
| `BotAccessConfig`                        | User Identity -> Bot Access                                                                                                   |
| `IdentityIngestionVars`                  | User Identity -> Import Users                                                                                                 |
| `IdentityServiceAccountVars`             | User Identity (Service Accounts)                                                                                              |
| `FileIngestionConfig`                    | Ingestion                                                                                                                     |
| `AccessAccountIntegrationConfig-Channel` | Channel Resolver -> Plugin Settings                                                                                           |
| `NudgeConfig`                            | Channel Resolver -> Plugin Settings                                                                                           |
| `ChannelVars`                            | Channel Resolver -> Channel Settings                                                                                          |
| `CustomAttributeConfig`                  | Analytics and Data -> Custom Attributes                                                                                       |
| `BPIConfig`                              | Analytics and Data -> Advanced Settings -> Bot Insights Settings                                                              |
| `CustomerValueConstantsVars`             | Analytics and Data -> Advanced Settings -> Analytics Value Settings                                                           |
| `AppConfig`                              | Analytics and Data -> Advanced Settings -> Analytics App Settings                                                             |
| `AppDataFilterConfig`                    | Analytics and Data -> Advanced Settings -> App Data Filter                                                                    |
| `AttributeDataSourceConfig`              | Analytics and Data -> Advanced Settings -> Attribute Data Source                                                              |
| `AttributeMappingConfig`                 | Analytics and Data -> Advanced Settings -> Attribute Mapping                                                                  |
| `UserAttributeMetadataConfig`            | Employee Communications -> Employee Communications                                                                            |
| `CustomDomainConfig`                     | Domains -> Domains                                                                                                            |

### Chat Platforms, Display & Notification Configs

| **Dropdown Value**      | **Setup Left-Nav Path**                      |
| ----------------------- | -------------------------------------------- |
| `ChatVars`              | Manage Chatbots -> Chatbots                  |
| `MoveWebChatAuthConfig` | Web Chatbot -> Authentication                |
| `MLSVars`               | Multilingual Support -> Language Preferences |
| `CopilotDisplayVars`    | Display Configurations -> Display Settings   |
| `DisplayVars`           | Display Configurations -> Display Settings   |
| `InfoConfig-Web`        | Display Settings -> Web-Form Styling         |
| `NotificationOrgConfig` | Notification Settings -> Notifications       |

### Organization Details

| **Dropdown Value**    | **Setup Left-Nav Path**                 |
| --------------------- | --------------------------------------- |
| `InfoConfig`          | Tenant Settings -> General Information  |
| `SSOConfig`           | Tenant Settings -> Single Sign-On (SSO) |
| `CustomerAlertConfig` | Alerts                                  |

## Frequently Asked Questions

* **What happens if I submit invalid JSON?**\
  The editor will reject the save and display an error. For example, submitting empty JSON returns **Error 13002**: *"Failed to save config due to precondition check: Unable to deserialize data."*
* **Are standard UI validations applied in JSON mode?**\
  No. UI validations such as required fields, minimum length, and DSL hints are **not** enforced in JSON mode. You are responsible for ensuring the JSON is valid and complete.
* **Can I create new configurations, or only edit existing ones?**\
  You can do both. For multi-cardinality configurations, use the **+ Add new config** option to create a new configuration from a blank template.
* **Will the JSON structure change in the future?**\
  Yes, the JSON structure may change in future updates. Always refer to the current configuration schema and avoid hardcoding assumptions about field names or structure.
* **Can I update secrets or sensitive credentials through this editor?**\
  No. Please refrain from updating secrets or sensitive credentials via the Advanced Configuration Editor. Secrets are represented as UUIDs mapped to values stored securely — direct modification is not supported in v1.
* **Why can't I find a specific configuration in the dropdown?**\
  Only approved, customer-facing configurations are shown. Internal UIVars and configurations that haven't been approved by engineering DRIs are intentionally hidden from the dropdown.