---
schema_version: "1"
id: 94607315a9022b99b6c24ba4fdf76814dfa7edb573143ace38dd52065c021a61
title: AssociationEngineSettings
collection: legacydeveloper
version: current
locale: en-us
portal_url: https://docs.salesforce.com/legacydeveloper/current/en-us/api_meta/meta_associationenginesettings.md
canonical_url: https://developer.salesforce.com/docs/atlas.en-us.api_meta.meta/api_meta/meta_associationenginesettings.htm
source_site: developer.salesforce.com
content_type: documentation
content_hash: e7a0259c02fed91b05125e2a236b1254fbe8e3cf3d03d33f602c419d8b766910
description: Represents the record association builder settings for an org. This type extends the Metadata metadata type and inherits its fullName field.
---
# AssociationEngineSettings

Represents the record association builder settings for an org. This type extends the Metadata metadata type and inherits its fullName field.

## Parent Type and Manifest Access

This type extends the [Metadata](https://developer.salesforce.com/docs/atlas.en-us.264.0.api_meta.meta/api_meta/metadata.htm) metadata type and inherits its fullName field.

In the package manifest, all the settings metadata types for the org are accessed using the “Settings” name. See [Settings](https://developer.salesforce.com/docs/atlas.en-us.264.0.api_meta.meta/api_meta/meta_settings.htm) for more details.

## File Suffix and Directory Location

AssociationEngineSettings values are stored in the AssociationEngine.settings file in the settings folder. The .settings files are different from other named components, because there is only one settings file for each settings component.

## Version

AssociationEngineSettings components are available in API version 52.0 and later.

## Special Access Rules

There are no additional access requirements that are specific to this type.

## Fields

| Field Name | Description |
| --- | --- |
| enableAssociationEngine | 
Field Type

boolean

Description

Automatically associates new accounts with the user’s current branch by creating branch unit customer records. The default value is false.



 |

## Declarative Metadata Sample Definition

The following is an example of an AssociationEngineSettings component.

<?xml version="1.0" encoding="UTF-8"?>
<AssociationEngineSettings xmlns="http://soap.sforce.com/2006/04/metadata">
  <enableAssociationEngine>true</enableAssociationEngine>
</AssociationEngineSettings>

The following is an example package.xml that references the previous definition.

<?xml version="1.0" encoding="UTF-8"?>
<Package xmlns="http://soap.sforce.com/2006/04/metadata">
  <types>
    <members>AssociationEngine</members>
    <name>Settings</name>
  </types>
</Package>

## Wildcard Support in the Manifest File

The wildcard character \* (asterisk) in the package.xml manifest file doesn’t apply to metadata types for feature settings. The wildcard applies only when retrieving all settings, not for an individual setting. For details, see [Settings](https://developer.salesforce.com/docs/atlas.en-us.264.0.api_meta.meta/api_meta/meta_settings.htm). For information about using the manifest file, see [Deploying and Retrieving Metadata with the Zip File](https://developer.salesforce.com/docs/atlas.en-us.264.0.api_meta.meta/api_meta/file_based_zip_file.htm).