# Manage Deep Links

A deep link directs a user to a specific resource, either within your app or on the web, when they interact with your message.

You can select a deep link when configuring:

* An [Action](https://www.airship.com/docs/reference/glossary/#action) in a Message, Automation, A/B Test, or Sequence.
* An [action](https://www.airship.com/docs/guides/messaging/in-app-experiences/configuration/button-actions/) in in-app experiences.
* An [action](https://www.airship.com/docs/guides/messaging/features/wysiwyg-editor/actions/) when creating content using the WYSIWYG editor.
* The *Link* element in a [rich page](https://www.airship.com/docs/reference/glossary/#rich_page) template. See:
   * [Message Center: Creating content: Visual editor](https://www.airship.com/docs/guides/messaging/messages/content/app/message-center/#visual-editor)
   * [Landing pages: Creating content: Visual editor](https://www.airship.com/docs/guides/messaging/messages/content/app/landing-pages/#visual-editor)

A deep link must be in the format of a URL or a custom app URL scheme. You can also create deep link *templates* — URLs with placeholders in the path. When you create a message specifying a deep link, each placeholder segment appears as an individual text field that you can populate.

When you create your deep link, items in the path surrounded by brackets are templated fields. For example, deep link to `http://www.widgets.com/products/{widgetType}` or `widgetapp://products/{widgetType}` will take the user to `http://www.widgets.com/products/` or the products page in the app, and the `widgetType` is a variable you can specify when you create your message.

For instructions for implementing deep links in your mobile app, see the Deep Link guide for your platform in [SDK Integrations](https://www.airship.com/docs/developer/sdk-integration/).

## Add a Deep Link

1. Next to your project name, select the dropdown menu (
), then **Settings**.
1. Under **App settings**, select **Deep Links**.
1. Click **Create Deep Link**.
1. Enter a *Name* for the deep link. This is how you will identify the deep link in messages.
1. Enter the *URL Template* for the deep link, no more than 1,024 characters. Example: `http://widgets.com/productivity/{calculator}` or `widgetapp://productivity/{calculator}`. Fields you enter using curly brackets `{}`, are templated fields that you can populate when you use a deep link in a message.
1. (Optional) Set a default value for any templated fields you added to the deep link.
![Manage Deep Links](https://www.airship.com/docs/images/new-deep-link3_hu_edd57262fa419c13.webp)
1. (Optional) Check the box to allow a non-standard URL pattern.
1. Click **Save**.

## Edit or Delete a Deep Link

1. Next to your project name, select the dropdown menu (
), then **Settings**.
1. Under **App settings**, select **Deep Links**.
1. Select the more menu icon () for a deep link, and then select **Delete**, or select **Edit**, make your changes, and select **Save**.

## Airship internal deep links

The Airship SDK provides several internal deep links with the `uairship://` scheme. These deep links are handled automatically by Airship messaging features and are not externally exposed.

Available internal deep links:

- `uairship://preferences/<PREFERENCE_CENTER_ID>` — Opens a preference center
- `uairship://message_center` — Opens the message center
- `uairship://message_center/message/<MESSAGE_ID>` — Opens a specific message in the message center
- `uairship://app_settings` — Opens the system app settings
- `uairship://app_store?itunesID=<IOS_ITUNES_ID>` — Opens the app's listing in the App Store

Any other `uairship://` deep links that are not handled by Airship automatically are delivered to your deep link callback if one is set in your app.

> **Note:** These internal deep links are used by Airship across all platforms. Do not expose them directly in your app's URL scheme. Instead, create your own deep links that map to Airship's internal links. For example, expose `myapp://airship/preference/<PREFERENCE_CENTER_ID>`, and when your app handles it, call Airship to display the preference center.

