---
schema_version: "1"
id: f77a1fbd28d67b39ff6d64fcb60ca787a7ac8de07be11e402ab726b99192d3f5
title: RedirectWhitelistUrl
collection: legacydeveloper
version: current
locale: en-us
portal_url: https://docs.salesforce.com/legacydeveloper/current/en-us/api_meta/meta_redirectwhitelisturl.md
canonical_url: https://developer.salesforce.com/docs/atlas.en-us.api_meta.meta/api_meta/meta_redirectwhitelisturl.htm
source_site: developer.salesforce.com
content_type: documentation
content_hash: 49ac9e24bb9231b4de88691b7c974d6ab91d80fa16c3bac20c6a29dd34677c29
description: Represents a trusted URL that’s excluded from redirection restrictions when the redirectionWarning or redirectBlockModeEnabled field on the SessionSettings Metadata type is set to true. This type extends the Metadata metadata type and inherits its fullName field.
---
# RedirectWhitelistUrl

Represents a trusted URL that’s excluded from redirection restrictions when the redirectionWarning or redirectBlockModeEnabled field on the SessionSettings Metadata type is set to true. This type extends the Metadata metadata type and inherits its fullName field.

![Important](https://developer.salesforce.com/docs/atlas.en-us.api_meta.meta/api_meta/images/icon_note_important.png)

#### Important

Where possible, we changed noninclusive terms to align with our company value of Equality. Because changing terms in our code can break current implementations, we maintained this metadata type’s name.

## File Suffix and Directory Location

RedirectWhitelistUrl components have the suffix .redirectWhitelistUrl and are stored in the redirectWhitelistUrls folder.

## Version

RedirectWhitelistUrl components are available in API version 48.0 and later.

## Special Access Rules

Only authenticated internal and external users with the View Setup and Customize Application permissions can access or edit this type.

## Fields

<table class="featureTable sort_table" summary="">



          <thead class="thead sorted" align="left">
            <tr>
              <th class="featureTableHeader  " id="d802343e109">Field Name</th>

              <th class="featureTableHeader  " id="d802343e112">Field Type</th>

              <th class="featureTableHeader  " id="d802343e115">Description</th>

            </tr>

          </thead>

          <tbody class="tbody">
            <tr>
              <td class="entry" headers="d802343e109" data-title="Field Name"><span class="keyword parmname">url</span></td>

              <td class="entry" headers="d802343e112" data-title="Field Type">string</td>

              <td class="entry" headers="d802343e115" data-title="Description">
                <p class="p">Required. The trusted URL.</p>
                <p class="p">These formats are accepted:
                  <span class="ph filepath">example.com</span>, <span class="ph filepath">*.example.com</span>, and
                  <span class="ph filepath">https://example.com</span>.
                </p>
                <p class="p">The host section of the URL can
                  include an asterisk (<samp class="codeph nolang">*</samp>) as a wildcard.
                  Otherwise, the URL cannot be malformed. Examples of malformed URLs that fail a
                  syntax check are <samp class="codeph nolang">malformed^url.example.com</samp>,
                  and <samp class="codeph nolang">https://{subdomain}.example.com</samp>.</p>
                <p class="p">To
                  add a <span class="keyword parmname">URL</span> based on parameters, build the URL before you add
                  it to this Metadata Type.</p>
              </td>

            </tr>

          </tbody>

        </table>

## Wildcard Support in the Manifest File

This metadata type supports the wildcard character \* (asterisk) in the package.xml manifest file. 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).