# Preference Center for the Apple SDK Display Preference Centers using the Airship UI, which automatically handles user preferences and syncs with the Airship backend. ![Preference Center for the Apple SDK](https://www.airship.com/docs/images/preference-center-apple_hu_615c93ae107ba1cb.webp) > **Important:** Airship Preference Centers are widgets that can be embedded in a page in an app or website. Please verify with your legal team that your full Preference Center page, including any web page for email Preference Centers, is compliant with local privacy regulations. The Preference Center allows users to opt in and out of subscription lists configured in the Airship Dashboard. The `AirshipPreferenceCenter` module provides a complete, ready-to-use UI that displays over your app. For more information about configuring Preference Centers, see the [Preference Center user guide](https://www.airship.com/docs/guides/messaging/features/preference-centers/). ## Displaying a Preference Center Display a Preference Center with a single method call. The Preference Center will appear in its own window over your app with the provided Airship UI. #### Swift ```swift Airship.preferenceCenter.display("my-first-pref-center") ``` #### Objective-C ```objc [UAirship.preferenceCenter display:@"my-first-pref-center"]; ``` This displays the Preference Center as an overlay window, allowing users to manage their subscription preferences. When the user closes the Preference Center, any changes are automatically synced with Airship. > **Note:** To embed the Preference Center directly in your app's navigation instead of displaying it as an overlay, see [Embedding the Preference Center](https://www.airship.com/docs/developer/sdk-integration/apple/preference-center/embedding/). You can also [intercept display requests](https://www.airship.com/docs/developer/sdk-integration/apple/preference-center/embedding/#handling-display-requests) to handle navigation to your embedded Preference Center. ## Applying a Custom Theme You can customize the appearance of the Preference Center by creating a `PreferenceCenterTheme` instance and setting its properties. The theme applies globally to all Preference Centers displayed in your app. ### Setting the Theme Programmatically (Swift) #### Swift ```swift // Customize your Theme var theme = PreferenceCenterTheme() theme.viewController = PreferenceCenterTheme.ViewController( navigationBar: PreferenceCenterTheme.NavigationBar( title: "My preference center", backgroundColor: .orange ) ) theme.preferenceCenter = PreferenceCenterTheme.PreferenceCenter( subtitleAppearance: PreferenceCenterTheme.TextAppearance( font: .subheadline, color: .yellow ), retryButtonBackgroundColor: .green, retryButtonLabelAppearance: PreferenceCenterTheme.TextAppearance( font: .title3, color: .black ) ) theme.contactSubscription = PreferenceCenterTheme.ContactSubscription( titleAppearance: PreferenceCenterTheme.TextAppearance( font: .title, color: .red ), subtitleAppearance: PreferenceCenterTheme.TextAppearance( font: .title2, color: .yellow ) ) theme.channelSubscription = PreferenceCenterTheme.ChannelSubscription( titleAppearance: PreferenceCenterTheme.TextAppearance( font: .title, color: .red ), subtitleAppearance: PreferenceCenterTheme.TextAppearance( font: .title2, color: .yellow ) ) // Set the Theme on the Preference Center Airship.preferenceCenter.theme = theme ``` ### Setting the Theme in SwiftUI In SwiftUI, you can apply a theme directly to the `PreferenceCenterView`: #### Swift ```swift PreferenceCenterView( preferenceCenterID: "preferenceCenter-ID" ) .preferenceCenterTheme(theme) ``` ### Setting the Theme from a Plist You can also customize the theme without writing code by creating a plist file. All keys in the plist correspond to properties on the `PreferenceCenterTheme` class. Colors are represented by strings, either a valid color hexadecimal (e.g., `#FF0000`) or a named color. Named color strings must correspond to a named color defined in a color asset within the main bundle. > **Note:** If your app is written in Objective-C, you must use the plist file to customize your theme, as `PreferenceCenterTheme` is a Swift struct. Save the plist as `AirshipPreferenceCenterTheme.plist` in your app bundle, then load it: #### Swift ```swift try Airship.preferenceCenter.setThemeFromPlist("AirshipPreferenceCenterTheme") ``` #### Objective-C ```objc NSError *error = nil; [UAirship.preferenceCenter setThemeFromPlist:@"AirshipPreferenceCenterTheme" error:&error]; if (error) { NSLog(@"Failed to set theme: %@", error); } ``` #### Example Theme Plist **AirshipPreferenceCenterTheme.plist** ```xml viewController navigationBar title Preference Center titleFont fontName Helvetica fontSize 15 titleColor #0000FF preferenceCenter subtitleAppearance commonSection titleAppearance color #de0000 font fontName Helvetica fontSize 32 subtitleAppearance color #da833b font fontName Helvetica fontSize 25 labeledSectionBreak titleAppearance channelSubscription titleAppearance color #034710 font fontName Helvetica fontSize 20 subtitleAppearance color #8fe388 font fontName Helvetica fontSize 15 contactSubscription titleAppearance color #034710 font fontName Helvetica fontSize 20 subtitleAppearance color #8fe388 font fontName Helvetica fontSize 15 contactSubscriptionGroup titleAppearance color #034710 font fontName Helvetica fontSize 20 subtitleAppearance color #8fe388 font fontName Helvetica fontSize 15 chip checkColor #3bd2d6 borderColor #0a0fc9 labelAppearance color #7c6bea font fontName Helvetica fontSize 15 alert titleAppearance color #0a0fc9 font fontName Helvetica fontSize 15 subtitleAppearance color #d1b4d4 buttonLabelAppearance color #78c8c0 font fontName Helvetica fontSize 25 buttonBackgroundColor #da833b ```