# Journeys {{< glossary_definition "journey" >}} Design multi-step, cross-channel messaging workflows to onboard, retain, and re-engage users. Create each component from scratch or use AI to create draft Journeys. ## The Journey map Select **Journeys** in the dashboard to access the Journey map. From there you can: * **Create and edit** the individual components of a Journey: a [Sequence](https://www.airship.com/docs/reference/glossary/#sequence), [Scene](https://www.airship.com/docs/reference/glossary/#scene), or [In-App Automation](https://www.airship.com/docs/reference/glossary/#iaa). * **Connect** components together to form a Journey. * **View** performance information for an individual component and a **mapped view** of its triggers, events, outcomes, and upstream and downstream connections. ![A Journey of connected messaging components](https://www.airship.com/docs/images/journey-map-welcome_hu_e4b5cb7c37e2fd83.webp) *A Journey of connected messaging components* > **Tip:** You can access the Journey map from additional locations: > * In the Sequence, Scene, or In-App Automation composer, select **Journey view**. > * From [Messages Overview](https://www.airship.com/docs/reference/glossary/#messages_overview), select the map icon ( > ). > * From the [Sequence Manager](https://www.airship.com/docs/reference/glossary/#sequence_manager) and [Performance](https://www.airship.com/docs/reference/glossary/#sequence_performance) screens, select **Outcomes**, then select **View in map**. ### Selecting a Journey component After opening the map, all Journey components are listed by name, along with: * **Status** — Draft, Live (Active), Paused, or Completed * **Type** — Sequence, In-App Automation, or Scene * **Last modified** — *Today*, or the number of days, months, etc., since the component was last edited, relative to the current date, time, and your time zone * **Journey map icon ( )** — Appears next to the component name if it is part of a Journey The default sort order is last modified, descending. Select the **Name** or **Last modified** column header to toggle ascending/descending order. The list filters as you enter search text, and you can manually filter by Status and Type. Archived components are not included in the list or returned in search results. Select a component in the list to open it in the map. ### Map cards After selecting a Journey component, it is represented as a card in the map, along with its triggers, events, outcomes, and upstream and downstream connections. When a Journey component has multiple triggers, they appear stacked, with the most recently added on top. If a trigger requires additional configuration, the line connecting to its component appears dashed. Select the trigger stack to expand and view all triggers, or select the component card to collapse the stack. The map displays data for all time by default. You can select a new time frame, and the map will reload with the data for that period. Select the X icon ( ) in the search bar to restore the map to its initial state. ![A draft Sequence in the Journey map](https://www.airship.com/docs/images/journey-map-sequence-draft_hu_3f6e3f04f7c7a04d.webp) *A draft Sequence in the Journey map* Each card in the Journey map displays its name, statistics, and status: Draft, Started, Paused, Completed, or Archived. Statistics do not appear for Draft and Archived. Sequences also display their number of messages, and Scenes also display their number of screens. Trigger configuration appears to the left of map cards. Sequence triggers Date Attribute, Recurring Schedule, and Specific Date and Time will not appear if the specified timing is outside of the selected time frame in the map. See [Sequence Triggers](https://www.airship.com/docs/guides/messaging/messages/sequences/triggers/) and [In-App Experience Triggers](https://www.airship.com/docs/guides/messaging/in-app-experiences/configuration/triggers/). Outcome configuration appears to the right of map cards. See [Sequence outcomes](https://www.airship.com/docs/guides/messaging/messages/sequences/create/outcomes/) and [Link Journey components](#link-journey-components). #### Sequence statistics After selecting a Sequence in the Journey map, these statistics appear on its card: | Statistic | Description | | --- | --- | | **In Progress** | The sum of **Users eligible for message** counts for all messages in the Sequence. | | **Conversions** | The rate of conversion, calculated by the number of users who exited the Sequence by a conversion event divided by the total number of times the Sequence was triggered. Conversions are labeled **Reactivations** for Sequences using the [Inactivity trigger](https://www.airship.com/docs/guides/messaging/messages/sequences/triggers/#inactivity). | | **Conversion trend** | For Sequences with a [Control Group](https://www.airship.com/docs/guides/experimentation/control-groups/), the difference between the [Baseline](https://www.airship.com/docs/reference/glossary/#baseline) and current conversion rates for the selected time frame. It appears in green for a positive trend and red for a negative trend. Select the trend to see the [Lift Rate](https://www.airship.com/docs/reference/glossary/#lift_rate), baseline, and the date the baseline was set. | #### In-App Automation and Scene statistics After selecting an In-App Automation or Scene in the Journey map, these statistics appear on its card: | Statistic | Description | | --- | --- | | **Impressions** | The total number of views by your audience | | **Dismissals** | The total number of times your audience closed the message without engagement, such as following a link or clicking a button | Select a Scene's **Impressions** count to view additional statistics, then select **View Detail** to open its message report. See [Scene Reports](https://www.airship.com/docs/guides/messaging/in-app-experiences/scenes/create/scene-reports/). Scene Impressions statistics: | Statistic | Description | | --- | --- | | **Completions** | For Scenes with more than one screen, the total number of times all screens in a Scene were displayed and the rate of completion | | **NPS Score** | For Scenes containing an [NPS survey](https://www.airship.com/docs/guides/messaging/in-app-experiences/configuration/content/#nps), the overall Net Promoter Score. Select the score to show/hide the percentages of Promoters, Passives, and Detractors. | | **Button Clicks** | For Scenes without an [NPS survey](https://www.airship.com/docs/guides/messaging/in-app-experiences/configuration/content/#nps), the total number of times your audience tapped the buttons in the Scene | > **Note:** Impressions and dismissals include multiple views/dismissals by a single user. Button clicks include all buttons in a message, and multiple clicks by a single user. ### Actions Select a card in the map to see available actions appear above the card. You may need to select the three dots icon ( ) to expose some actions. A message's current status is displayed in a dropdown menu. Make a selection from the dropdown menu to [change the message status](https://www.airship.com/docs/guides/messaging/manage/change-status/) or [archive the message](https://www.airship.com/docs/guides/messaging/manage/archive/). Actions for components in the Journey map: | Action | Description | Steps | | --- | --- | --- | | **Edit** | Opens the message in its composer. See also [Edit a Sequence](https://www.airship.com/docs/guides/messaging/messages/sequences/create/edit/) and [Edit a message](https://www.airship.com/docs/guides/messaging/manage/edit/). | Select the compose icon ( ). | | **Publish Sequence changes** | Applies unpublished edits to a Sequence. For Paused Sequences, it also makes the Sequence Active/Live/Started, which is the same as selecting ** Start** from the [Sequence Manager](https://www.airship.com/docs/reference/glossary/#sequence_manager). | Select the cloud upload icon. | | **Duplicate** | Creates a copy in draft state and reloads the map with the duplicate selected. The draft has the same name as the original, with "- Copy" appended. | Select the duplicate icon ( ). | | **Unlink** | Removes a component from a Journey. The map will refresh to focus on the component you unlinked. See also [Unlink Journey components](#unlink-journey-components) | Select the unlink icon. | | **Delete** | Deletes a draft Scene or In-App Automation from your project. Once they have been started they cannot be deleted, only archived. Sequences cannot be deleted, only archived. | Select the trash can icon ( ). | | **Open report** | For Started/Live/Active messages, opens the Sequence [Performance report](https://www.airship.com/docs/reference/glossary/#sequence_performance), the [In-App Automation message report](https://www.airship.com/docs/guides/reports/message/), or the [Scene message report](https://www.airship.com/docs/guides/messaging/in-app-experiences/scenes/create/scene-reports/) | Select the report icon ( ). | ## Create Journey components Quickly create draft Sequences, In-App Automations, and Scenes in the Journey map by entering a message name or selecting a [Sequence Template](https://www.airship.com/docs/reference/glossary/#sequence_template). After creating the draft, the map opens with the new component selected. For a Sequence based on a template, select the plus icon () in the map, and then select a template. For a Sequence, In-App Automation, or Scene: 1. Go to **Journeys**. 1. Select the plus icon () in the map. 1. (Sequence only) Select **Start from scratch**, and then enter a name. 1. (In-App Automation or Scene only) Select **In-App Experience**, then select **In-App Automation** or **Scene**, and then enter a name. 1. Select **Continue**. > **Note:** The plus icon () is only available in the map when you first load the Journeys page. If you already made a selection from the sidebar list or map, select the X icon ( > ) in the search bar to restore the map to its initial state. > > You can also access the same menu from the sidebar: Select the **Create** dropdown menu ( > ), then **Journey**. ## Create AI-generated Journeys [AXP](https://www.airship.com/docs/reference/feature-packages/) [Generative AI](https://www.airship.com/docs/guides/features/intelligence-ai/ai/) Use Generative AI to create draft Journeys. After generation, the map displays all linked components. You can create up to 100 AI Journeys per project. Explicit content is excluded for all languages. 1. Go to **Journeys**. 1. Select the plus icon () in the map. 1. Configure the prompts:
Prompt Description Steps
Generate a Journey for The purpose of the Journey, used to name each component and to generate message content Enter text.
include the following details The information you want to convey in your message content Enter text.
where we message users with The message types to included in the Journey: [Push Notification](https://www.airship.com/docs/reference/glossary/#push_notification), [Message Center](https://www.airship.com/docs/reference/glossary/#message_center), [Web Push Notification](https://www.airship.com/docs/reference/glossary/#web_push_notification), [SMS](https://www.airship.com/docs/reference/glossary/#sms), [MMS](https://www.airship.com/docs/reference/glossary/#sms), Email, [Scene](https://www.airship.com/docs/reference/glossary/#scene), [Story](https://www.airship.com/docs/reference/glossary/#story), and/or Survey (a Scene that includes an NPS survey or questions) Select at least one message type.
when they The user event that initiates the Journey
  • Supported for Scenes: App Open, App Update, Feature Flag Interaction Event, Screenview
  • Supported for Sequences: Contact Association, Feature Flag Interaction Event, First Seen, Location, Predicted to Churn, Subscription
 Select a trigger.
presented in the language of The language of the message content Select a language.
using the personality The message content voice and tone determined by a personality defined in your brand guidelines Select a personality.
users will The outcome of a Sequence included in the Journey: None ensures all triggered messages are sent, Convert and Cancel remove a user from the Journey based on their performing a specific [Custom Event](https://www.airship.com/docs/reference/glossary/#custom_event) Select an outcome. For Convert or Cancel, also search for and select a Custom Event or select Use <search term> to use an event name as entered.
include images of Descriptions of images to include in messages Enter text.
1. Select **Generate**. Next, edit each component and finalize your trigger, content, and other settings. See full documentation: * [Sequence configuration](https://www.airship.com/docs/guides/messaging/messages/sequences/create/) * [Scene configuration](https://www.airship.com/docs/guides/messaging/in-app-experiences/configuration/) > **Note:** **Opting In to AI Functions** > > If you opted out of AI usage, you must sign an updated contract to enable this feature. Contact your account manager for assistance. > > **Compliance Considerations in Using AI Functions** > > The Service incorporates AI functions, including Generative AI and Agentic AI. > > Generative AI generates content such as Notification copy, images, and Journeys based on your prompts. > > Agentic AI autonomously optimizes, personalizes, or executes cross-channel customer engagement actions, or analyzes audience and performance data, subject to the parameters and controls you set in the Service. These systems operate under human-defined parameters and do not initiate customer-facing actions without human interaction or pre-configured parameters. You are responsible for reviewing Generated Outputs for accuracy, appropriateness, and to ensure they do not violate third-party intellectual property or other rights. Airship does not publish Generated Outputs to end users without approval from the Customer. > > In addition to the applicable terms of your agreement with Airship (e.g., Use of Service, Customer Responsibilities sections), you must comply with the [Airship Acceptable Use Policy](https://www.airship.com/legal/acceptable-use/), which provides additional details about appropriate conduct when using the Service. > > The Service includes safety features to block harmful content, such as content that violates our Acceptable Use Policy. You may not attempt to bypass these protective measures or use content that violates your agreement with Airship. > > About the AI models: > > Airship utilizes Google Gemini and Imagen to generate copy and images for AI Scene screens. The content is created solely with Google's out-of-the-box models, and no customization or fine-tuning with Customer Data is applied. See [Responsible AI](https://cloud.google.com/responsible-ai?hl=en) in Google's *Google Cloud* documentation. > **Tip:** When creating an AI Journey, use the **include the following details** field for essential information like product features, unique selling points, or call-to-action elements to make the generated content more accurate and aligned with your goals. For example, for a Mother's Day Sale, include details such as "The sale is for 2 weeks, the offer is 30% off beauty and luxury items." You could also provide the information in a shorter, keyword format: "2 week sale, 30% off beauty and luxury." > > For **include images of**, make sure to describe specific visual elements. Mention key visual details like colors, objects, setting, or style to ensure the images match your Journey vision. For example, "Create a soft, pastel-colored image featuring flowers, gift boxes, and a 'Mother's Day Sale' banner." Or use keywords "flowers, gift boxes, and 'Mothers Day Sale' banner, soft-pastel background." > > Also add context and emotion. Including the mood or context can help capture the desired tone or feeling for each image. For example, "Generate a warm, loving image of a mother receiving a gift." ## Link Journey components You can link Journey components in these ways:
Link from To Description Steps
Sequence Sequence Route users to another Sequence when Airship sends the last message in the current Sequence or when a specific event occurs. See Sequence outcomes.
Sequence In-App Automation or Scene Route users to an in-app experience when Airship sends the last message in the current Sequence or when a specific event occurs. If the downstream In-App Automation or Scene does not display on a user's device within a certain period, they will exit the Journey. As an alternative to leaving the Journey, you can route to a fallback Sequence. See Sequence outcomes.
In-App Automation or Scene Sequence Route users to a Sequence when an in-app experience displays on a device or when a user selects a button.

For Scenes, you can also route to a Sequence when a user submits answers to questions, submits responses to an NPS survey, or based on a user's response to a location opt-in or push opt-in prompt.

 See steps following this table.
In-App Automation or Scene In-App Automation or Scene1 [iOS SDK 18.4+](/docs/docs/developer/sdk-integration/apple/ios-changelog/#18.4.0) (Android SDK 18+)

Route users to another In-App Automation or Scene after the first one displays on a device or when a user selects a button.

For Scenes, you can also route to an In-App Automation or Scene when a user submits answers to questions, submits responses to an NPS survey, or based on a user's response to a location opt-in or push opt-in prompt.

Not supported for Web Scenes.

 See steps following this table.
1. To hide this option in the dashboard, see Enabling features in Enable dashboard features and set behavioral defaults. To link from an In-App Automation or Scene to a Sequence, In-App Automation, or Scene: 1. Go to **Journeys** and [select an In-App Automation or Scene](#selecting-a-journey-component). 1. Select the plus icon () to the right of its map card. A configuration drawer will open. 1. Select **Impression**, **Survey Submission**, **Button Tap**, or **Opt-in**. 1. (For Button Tap only) Select a button. 1. (For Opt-in only) Select the opt-in response for a button. 1. Select **Create New** or **Insert Existing**. 1. Select **Sequence**, **In-App Automation**, or **Scene**. 1. Search for and select an existing message or enter a name for a new draft. In search results, the node icon ( ) appears next to items that are already part of a Journey. 1. Select **Save**. The map will update to show the link to the downstream component. ## Unlink Journey components Unlinking an In-App Automation or Scene disconnects it from all upstream Sequences. When unlinking a Sequence, you can view all its upstream components and select which ones to unlink from. Anything downstream of the unlinked component will remain unchanged. After unlinking, the map reloads to focus on the unlinked component. ![Unlinking a Sequence from a Journey](https://www.airship.com/docs/images/journey-unlink-sequence_hu_7bdfd41752dec63a.webp) *Unlinking a Sequence from a Journey* To unlink an In-App Automation or Scene from a Sequence: 1. Go to **Journeys**. 1. [Select an In-App Automation or Scene](#selecting-a-journey-component). 1. Select the three dots icon ( ) on its card, then select **Unlink**. To unlink a Sequence from any Journey component: 1. Go to **Journeys**. 1. [Select a Sequence](#selecting-a-journey-component), and then select the unlink icon. A modal displays a list of upstream components the Sequence is connected to. The top-level list items are each component by name. Under each component name is a list of its connections to the Sequence you want to unlink:
Component Connection types
In-App Automation or Scene Impression, Survey Submission, Button Tap, or Opt-in
Sequence Continuation, Conversion, or Cancellation

Conversion and Cancellation are followed by the outcome type (Contact Association or Subscription Event) or the actual Custom Event name or Tag ("<Event name or Tag>").

1. Select which upstream components the Sequence should be unlinked from. 1. Select **Unlink Sequence**.