App and web preference centers

A preference center is a page where users can manage their opt-in statuses for the subscription lists in your project.

You design the appearance of app and web preference centers in the Settings section of your Airship project, your developer adds it to your website or app, and your users access it like any other page within your app or website. How it works:

  • Design a preference center — Preference centers are made of page sections, each with an optional title and description. They can be displayed as an individual page in your app or website, or embedded in another page.

    Add the text and sections you want in the page, and select at least one subscription list per section. You may also customize subscription list names and descriptions to override those from your project settings.

  • Developer — After you save the preference center, copy its ID and give it to your developer so they can make it appear in your app or website. See the Adding a preference center to your app or website on this page for additional information.

    After the preference center has been added to your app or website, you can change the design in the Airship dashboard at any time. Your saved edits are published in real time, no developer work required.

  • Update — When a user changes their opt-in status for a Subscription ListAn audience list of opted-in devices, browsers, and/or email addresses. in an app preference center, their status is updated for the respective device or browser.

 Tip

You can save an empty/undesigned preference center as a placeholder if your developer needs the ID immediately.

Creating an app or web preference center

 Note

Only the company account owner or a team member with administrator permissions can create app and web preference centers. See: Manage Access Levels.

Design the preference center in your project settings. Select Mobile App or Web for the preference center Type.

  1. Go to Settings » Project configuration » Preference Centers and click Manage.
  2. Click Create preference center.
  3. Provide the preference center details:
    • Name and Description — These appear in the Airship dashboard only. The preference center ID is automatically generated based on the name.
      • An ID will not generate for a name that contains only numbers and/or special characters.
      • If the name starts with a number and/or special characters, the generated ID omits the leading numbers and/or special characters.
      • Uppercase letters in the name are converted to lowercase in the ID.
      • Special characters in the name are converted to underscores in the ID and only appear if followed by numbers or letters.
    • Type — Options: Mobile App, Web, Email.
    • ID — You can enter your own ID instead of using the auto-generated one, using letters, numbers, and underscores. The ID must start with a letter and end with a letter or number. You cannot change the ID later.
  4. Click Continue.
  5. (Optional) Enter a title and description for the preference center.
    • For apps, these appear in the navigation bar at the top of your preference center. If you do not enter a title, the default title Notifications appears.
    • For web, your developer can control how these appear (or do not appear) in the preference center on your website.
    • For email, the title is a level-one HTML heading (<h1>), and the description is an HTML paragraph (<p>). They inherit whatever styles apply more generally from the surrounding page.
  6. (Optional) Enter a header and description for the page section. These appear above the subscription lists you add to the section. You may want to group related lists under a single header for better organization of your preference center.
    • For web, your developer can control how these appear (or do not appear) in the preference center on your website.
    • For email, the header is a level-two HTML heading (<h2>), and the description is an HTML paragraph (<p>).
  7. Search for and select a subscription list. Repeat to add multiple lists.
    • Click   next to a list to edit the list name and description, or to remove the list from the section. Edits to the name and description appear in the preference center only.
  8. Click   Add another section to add multiple page sections. Click   to reorder or remove or remove a page section.
  9. Click Save and publish.

Adding a preference center to your app or website

Your app or web developer must update the SDK and place the preference center widget in the desired area in your app or website, referencing a preference center ID.

For details on implementing a preference center in your app or website, see our platform SDK docs:

Linking to an app preference center

For web preference centers, you can copy and paste the link for its page on your website. For app preference centers, you can link to its page within your app as:

Managing app and web preference centers

 Note

Only the company account owner or a team member with administrator permissions can manage app and web preference centers. See: Manage Access Levels.

Your app and web preference centers are listed in Settings » Project configuration » Preference Centers.

  • Filter — Published preference centers are listed by default. Click Archived to see all archived preference centers.
  • Sort — The default sort order is most recently modified first. Click a column header to sort by name, ID, date created, or date modified.
  • Edit — Click  . You can edit the preference center name, description, and design. Your saved edits are published to your app or website immediately.
  • Duplicate — Click   and enter a new name, type, ID, and description. The name field is the original web page name with copy appended. Then click Continue, complete your design, and publish the page.
  • Archive — Click  . Archiving a preference center removes it from the Airship dashboard only; it does not affect its usage in your app or website.