# Institution Settings
source: https://developer.mastercard.com/open-finance-us/documentation/connect/connect-institutions-settings/index.md

## Financial Institution Search List {#financial-institution-search-list}

You can change the financial institutions (FIs) search list that displays in a Data Connect session using the `institutionSettings` parameter in the body of the request for the [Generate Data Connect URL APIs](https://developer.mastercard.com/open-finance-us/documentation/connect/generate-2-connect-url-apis/index.md).

For OAuth connections, you can manage whether you want early adoption of a new OAuth connection or later adoption during the final migration.

**Example** : If your partner ID is registered at an OAuth institution, then set `institutionSettings: autoreplace` so that only OAuth institutions return. If you decide to go back to a legacy connection, then override the `institutionSettings` parameter when you generate a Data Connect URL link to display the legacy institutions.

### Client Institution Settings {#client-institution-settings}

Set your environment with different institution settings to change the results of the institutions that display in the search list.

* [hidden](https://developer.mastercard.com/open-finance-us/documentation/connect/connect-institutions-settings/index.md#hidden-hide-financial-institutions) - Hide a specific institution(s) from the search list.

* [visible](https://developer.mastercard.com/open-finance-us/documentation/connect/connect-institutions-settings/index.md#visible-change-hidden-financial-institution-to-visible) - Display new connections include testing environments.

* [replace](https://developer.mastercard.com/open-finance-us/documentation/connect/connect-institutions-settings/index.md#replace-override-legacy-financial-institutions) - Replace legacy institutions with new connections. When OAuth connections are launched, this setting is automatically updated.

* [autoreplace](https://developer.mastercard.com/open-finance-us/documentation/connect/connect-institutions-settings/index.md#autoreplace-legacy-financial-institutions) - This determines if a customer is using legacy institutions. Accounts connected with a legacy institution won't see new OAuth FIs replacing the legacy institutions. If no legacy accounts exists, then new OAuth FIs display.

Note: Contact your Mastercard sales engineer (SE) to help you set the institution settings.

## Institution Settings {#institution-settings}

In the [Generate Data Connect URL APIs](https://developer.mastercard.com/open-finance-us/documentation/connect/generate-2-connect-url-apis/index.md), use the `institutionSettings` parameter to temporarily override the [Client Institution Settings](https://developer.mastercard.com/open-finance-us/documentation/connect/connect-institutions-settings/index.md#client-institution-settings) per Data Connect session.

```JSON
{
  "partnerId": "1445585709680",
  "customerId": "1005061234",
  "institutionSettings": {
    "5": "hidden",
    "1407": "hidden",
    "102224": "autoreplace"
  }
}
```

### hidden: Hide Financial Institutions {#hidden-hide-financial-institutions}

Hide an individual institution or a set of institutions for a specific Data Connect session.

```JSON
{
  "institutionSettings": {
    "5": "hidden",
    "1407": "hidden"
  }
}
```

### visible: Change Hidden Financial Institution to Visible {#visible-change-hidden-financial-institution-to-visible}

When new OAuth connections become available, you can internally test the connection by making the FI visible in Data Connect's search list for institutions. If the OAuth connection is new and the legacy connection is still available, then two FIs with the same name will display in the search list.

```JSON
{
  "institutionSettings": {
    "102224": "visible"
  }
}
```

### replace: Override Legacy Financial Institutions {#replace-override-legacy-financial-institutions}

When a new OAuth institution goes live, eventually all of your customers will automatically migrate to the new OAuth connection. If you want to opt-in for early adoption of the OAuth connection, and override all legacy FIs per a Data Connect session, then pass `institutionSettings: replace` in the body of the request call to the [Generate Data Connect URL APIs](https://developer.mastercard.com/open-finance-us/documentation/connect/generate-2-connect-url-apis/index.md).

```JSON
{
  "institutionSettings": {
    "102224": "replace"
  }
}
```

### autoreplace: Legacy Financial Institutions {#autoreplace-legacy-financial-institutions}

When set for a new OAuth institution, if a customer already has accounts from previous legacy institutions, the new OAuth institution does not display. This enables legacy customers to carefully migrate to the new OAuth connection before it is displayed.

Customers without legacy institutions display the new OAuth institutions in the search list.

```JSON
{
  "institutionSettings": {
    "102224": "autoreplace"
  }
}
```