Create a survey

Set up surveys that appear in your app when users meet certain conditions. Surveys are an AXP feature.

To get started, click   and select Survey. After completing a step, click   in the header to move on. Click   if you want to change the survey name or flag it as a test.


Enter a survey name, then configure optional features. The name appears in reporting and Messages OverviewA view of all your project’s messages, with options for editing their settings, content, status, and more. .


Select your survey audience:

  • All Users: Display the survey to your entire audience.
  • Test Users: Predefined recipient groups. After choosing Test Users, select from the Test Groups dropdown menu that appears. See: Preview and Test Groups.
  • Target Specific Users: Create a recipient group based on available conditions. See: Target Specific Users: In-App Automation.


Configure the content of your survey. A preview updates as you type and make selections. See About surveys: Appearance and behavior for configuration details.

First select a template and click Continue with selected template. You cannot change template selection after continuing.

Click Settings in the sidebar to choose the survey style and configure the dismiss button. Enter a hexadecimal value for the button color.

Click Design in the sidebar to set the appearance of the survey background and buttons, and the text for any header, body, question, and answer. Header and body configuration do not appear here until you add them to the survey. These settings are for this survey only and override your project-level design settings. Enter hexadecimal values for colors.

Edit or delete the default questions to suit the purpose of your survey. To add more content, click Add content   and make a selection, then configure:

  • Media — Enter an HTTPS URL that will be accessible by your mobile audience. If your Airship plan includes CDN support you can also upload media or select from previously uploaded media. Contact Support if you are interested in enabling CDN media hosting.
    1. Select Upload and click Insert Media.

      1. Click Choose file and select a file to upload, or select from previous uploads.

        • The default sort order is most recent upload first.
        • You can search by file name or keyword.
        • A file preview appears after upload or selection. Click   to preview audio and video files.
      2. (Optional) Add or edit keywords for the file to help organize your uploads.

        • Enter a term in the search field below the preview and select from results, or click Add keyword: [term].
        • Click   to remove a keyword.
      3. Click Insert selected media.

    To reorder your content, including question answers, click and hold   and drag and drop in new positions in the survey. The answer order is ignored if you checked Randomize order.


    Customize the Submit button and add more buttons.

    Privacy Terms

    Enable Privacy Terms to add a link to privacy terms to help users understand your data collection practices. Enter the link text and add the URL.


    Configure the trigger that will cause the survey to appear to users. You can also configure cancellation events, display conditions, and set a tag when the survey is displayed.


    Review your survey. If you want to make changes, click EDIT, make your changes, then either click   or click the central navigation dot to return to the Review step. If you exit before this final step, the survey is still a draft and not yet active.

    Click Finish to make the survey active.