---
schema_version: "1"
id: d6028c0446bfd9576fe5c76d4a48174bbc1ffc5796fb9b0202342ff44b934efb
title: Managing Global Configuration Elements
collection: mulesoft
version: current
locale: en-us
portal_url: https://docs.salesforce.com/mulesoft/current/en-us/anypoint-code-builder/int-global-config-elements.md
canonical_url: https://docs.mulesoft.com/anypoint-code-builder/int-global-config-elements
source_site: docs.mulesoft.com
content_type: documentation
content_hash: e571dc1adbbe5b8f1ba6286923b74c99ae21917d274cc0e509331b068b88b29a
description: MuleSoft Documentation Site
latest: true
---
---
product: Anypoint Code Builder
version: master
---

# Managing Global Configuration Elements

> For the full documentation index, see: https://docs.mulesoft.com/llms.txt

Add, edit, and delete global configurations in Anypoint Code Builder from **Global Elements**.
Create connector configurations, TLS contexts, object stores, caching strategies, API Autodiscovery,
global error handlers, import project references, and properties files. Manage the same
configurations in **Global Elements**, through MuleSoft Vibes, or in the source editor.

## Before You Begin

- [Set up and access Anypoint Code Builder](https://docs.mulesoft.com/anypoint-code-builder/start-acb).

- [Create an integration project](https://docs.mulesoft.com/anypoint-code-builder/int-create-integrations).

## Open Global Elements

Open **Global Elements** from **Project Properties** to view and manage the global configurations
defined in your project.

1.  Use one of these options:

    - In the canvas toolbar, click the ![](/mulesoft/current/en-us/anypoint-code-builder/_images/icon-manage-global-elements.png) (**Manage Global
      Elements**) icon to open **Project Properties** with the **Global Elements** tab selected.

    - In the Explorer, right-click your project and select **Mule** > **Manage Global Elements**.

      Alternatively, select **Mule** > **Open Mule Project Properties** and then click **Global
      Elements** from the menu.

      **Global Elements** shows a searchable table with the **Type**, **Name**, and **Notes** for
      each element.

2.  In **Selected File**, select a configuration file and view its elements.

3.  After you select a file, select **New Configuration** to create a configuration, or use MuleSoft
    Vibes.

    The table updates in real-time as you make changes.

## Add a Global Configuration

Add connector configurations and other global configuration types from **Global Elements**.

To add a global configuration:

1.  Open [**Global Elements**](#open-global-elements-panel).

2.  Select a configuration file from **Selected File**.

3.  Click **New Configuration**.

4.  In **Select configuration type**, search for or browse to the type you want.

    Types are grouped by category:

    - **Component Configurations**

    - **Global Configurations**

    - **Connector Configurations**

    - **Caching Strategies**

5.  Select a type. A form opens, scoped to the file you selected.

6.  Complete the required fields and save.

The new element appears in the **Configured Elements** table and is written to the selected
configuration file.

You can also add global configurations through MuleSoft Vibes using natural language. The element is
created with the correct structure and placed in the right file automatically. For example:

- _"Add a Salesforce connector config"_

- _"Register a new properties file"_

- _"Create an HTTP Listener global config on port 8081"_

For more details on using Vibes to manage global elements, see
[Use MuleSoft Vibes to Manage Global Configurations](#vibes-manage-global-configs).

## Edit a Global Configuration

To edit an existing element, use one of these methods:

- **Form editor** — Click the **More actions** (**…​**) menu next to the element and select
  **Edit**. A form-driven editor opens with field validation so you can update the configuration.
  Form editing is available for connector configurations and for these global configuration types:

  - TLS Context

  - Object Store

  - Caching Strategy

  - API Autodiscovery

  - Global Error Handler

  - Import Project Reference

  - Properties

- **Source editor** — Click **More actions** (**…​**) > **Go to Source** to jump directly to the
  element’s location in the XML file and edit it in context. Use this option for elements that don’t
  open in the form editor.

- **MuleSoft Vibes** — Describe your change conversationally and Vibes applies it for you.

## Remove a Global Configuration

Delete connector configurations and other global configuration elements from **Global Elements**.

To delete a global configuration:

1.  Open [**Global Elements**](#open-global-elements-panel).

2.  In the **Configured Elements** table, click the **More actions** (**…​**) menu next to the
    element.

3.  Select **Delete**.

4.  Confirm the deletion when the dialog names the element.

The element is removed from the configuration file, and the list refreshes.

You can also remove a global configuration through MuleSoft Vibes. For example:

- _"Remove the Salesforce connector config"_

- _"Delete the HTTP Listener global config"_

Before removing an element, Vibes identifies any flows that reference it and warns you of the impact
before making any changes.

## Consolidate Global Configurations

If global elements are scattered across multiple configuration files, consolidate them into a single
`global-configs.xml` file.

To consolidate from **Global Elements**:

1.  Open [**Global Elements**](#open-global-elements-panel).

2.  Click **Consolidate**.

Anypoint Code Builder combines global configurations from all project files into
`global-configs.xml` and updates flow file references.

To consolidate through MuleSoft Vibes, see
[Centralize Configurations from Studio Projects](#centralize-studio-projects).

## Manage Configuration Properties Files

When you create a new project, Anypoint Code Builder automatically generates a `global-configs.xml`
file for storing configuration properties separately from flow definitions. If you open a project
migrated from Studio, Anypoint Code Builder preserves the existing project structure.

### Register a Properties File

To register a `.yaml` or `.properties` file as a configuration source, click **New Configuration**
in **Global Elements** and select the configuration properties type. You can also use MuleSoft
Vibes. For example:

- _"Register a new properties file"_

- _"Add config.yaml as a configuration properties file"_

Anypoint Code Builder adds a `<configuration-properties>` element to your global config XML and the
file appears in **Global Elements**, under **Configuration Properties**.

### Add Inline Global Properties

To add `<global-property>` key-value pairs, click **New Configuration** in **Global Elements** and
select the global property type. You can also use MuleSoft Vibes. For example:

- _"Add a global property named env with value dev"_

All inline properties are stored in `global-configs.xml` instead of individual application XML
files.

## Set Up Multi-Environment Configuration

Anypoint Code Builder supports the `$site.yaml` file pattern for environment-specific property
files.

If your project contains files such as `dev.yaml`, `qa.yaml`, and `prod.yaml`, they appear in the
**Environments** section of **Global Elements**.

To set the default environment, use MuleSoft Vibes. For example:

- _"Set the default environment to dev"_

- _"Set up multi-environment configuration for dev, QA, and prod"_

Vibes adds a corresponding `<global-property>` element to your global configuration file, for
example: `<global-property name="env" value="dev"/>`.

Use **Preview Mode** to switch the active environment and verify that property placeholders resolve
correctly before you deploy.

## Work with Secure Properties

Anypoint Code Builder supports the Mule Secure Properties module:

- Generate encrypted property values from Anypoint Code Builder.

- Anypoint Code Builder warns you when a properties file contains unencrypted credentials.

For information about encrypting values and referencing them in your Mule application, see
[Defining and Securing Properties for a Mule Application](https://docs.mulesoft.com/anypoint-code-builder/int-create-secure-configs). To edit a
secure properties configuration from **Global Elements**, see
[int-create-secure-configs.adoc#edit-via-ui](https://docs.mulesoft.com/anypoint-code-builder/int-create-secure-configs#edit-via-ui).

## Global Element Types

In addition to connector configurations, you can add, edit, and delete these global configuration
types from **Global Elements**:

<table><colgroup><col> <col></colgroup><thead><tr><th>Component</th><th>What It Does</th></tr></thead><tbody><tr><td><div><div><p><strong>Global Error Handler</strong></p></div></div></td><td><div><div><p>Set any error handler as the application-wide default. You can also reference handlers from imported projects for consistent exception management across teams.</p></div></div></td></tr><tr><td><div><div><p><strong>API Autodiscovery</strong></p></div></div></td><td><div><div><p>Configure your Mule application for API Manager auto-discovery at deployment time. Select from the flows defined in your application when configuring the auto-discovery settings.</p></div></div></td></tr><tr><td><div><div><p><strong>TLS Context</strong></p></div></div></td><td><div><div><p>Set up Trust Store and Key Store configurations once, then reference them from any connector that supports TLS.</p></div></div></td></tr><tr><td><div><div><p><strong>Import Project Reference</strong></p></div></div></td><td><div><div><p>Import a JAR containing a shared Mule project. Use its flows, error handlers, and connection configurations. Anypoint Code Builder handles POM dependency management. When you import from a project dependency, specify the Mule configuration file to import.</p></div></div></td></tr><tr><td><div><div><p><strong>Caching Strategy</strong></p></div></div></td><td><div><div><p>Define a centralized caching strategy that you can reference from Cache scopes across the project.</p></div></div></td></tr><tr><td><div><div><p><strong>Object Store</strong></p></div></div></td><td><div><div><p>Create an object store to use with a caching strategy or other components that persist data.</p></div></div></td></tr><tr><td><div><div><p><strong>Configuration Properties</strong></p></div></div></td><td><div><div><p>Register a <code>.yaml</code> or <code>.properties</code> file, or add inline global properties, so your application can resolve placeholders consistently.</p></div></div></td></tr></tbody></table>

For API Autodiscovery configuration details, see
[Configure API Autodiscovery for Local Testing](https://docs.mulesoft.com/anypoint-code-builder/int-configure-api-autodiscovery-local) and
[Tracking Requests with Autodiscovery](https://docs.mulesoft.com/anypoint-code-builder/int-autodiscovery-config).

## Use MuleSoft Vibes to Manage Global Configurations

You can use MuleSoft Vibes to create and update global elements by using natural language prompts.

### Automatic Generation

When Vibes generates a flow that uses a connector, it also generates the corresponding global
configuration element. Credentials are stored as property placeholders, and a sample properties file
is created for the generated configuration.

### Natural Language Examples

You can ask Vibes things like:

- _"Create an HTTP Listener global config on port 8081"_

- _"Set up multi-environment configuration for dev, QA, and prod"_

- _"Centralize all global configs into the global-configs.xml file"_

- _"What global elements are defined in this project?"_

- _"Validate my property placeholders"_

### Centralize Configurations from Studio Projects

If your project has global elements scattered across multiple config files (common in projects
migrated from Studio), ask Vibes to consolidate them:

_"Move all global configs into global-configs.xml"_

Vibes identifies every global element across your config files, moves them to `global-configs.xml`,
and updates all flow file references automatically.

You can also click **Consolidate** in **Global Elements**. See
[Consolidate Global Configurations](#consolidate-global-configs).

The `manage-global-configurations` skill powers these operations. For more on skills in MuleSoft
Vibes, see [Using Skills with MuleSoft Vibes](https://docs.mulesoft.com/anypoint-code-builder/vibes-skills).

## See Also

- [Configuring Components](https://docs.mulesoft.com/anypoint-code-builder/int-configure-components)

- [Defining and Securing Properties for a Mule Application](https://docs.mulesoft.com/anypoint-code-builder/int-create-secure-configs)

- [Configure API Autodiscovery for Local Testing](https://docs.mulesoft.com/anypoint-code-builder/int-configure-api-autodiscovery-local)

- [Tracking Requests with Autodiscovery](https://docs.mulesoft.com/anypoint-code-builder/int-autodiscovery-config)

- [MuleSoft Vibes Overview](https://docs.mulesoft.com/anypoint-code-builder/mulesoft-vibes)
