--- title: "iOS App White-Labeling" slug: "ios-app-white-labeling" description: "White-label Rocket Chat iOS apps. Customise branding and deliver secure communication for iOS users." updated: 2026-09-08T18:25:57Z published: 2026-09-08T18:25:57Z canonical: "developer.rocket.chat/ios-app-white-labeling" --- > ## Documentation Index > Fetch the complete documentation index at: https://developer.rocket.chat/llms.txt > Use this file to discover all available pages before exploring further. # iOS App White-Labeling ## General setup 1. Open [RocketChatRN.xcworkspace]( https://github.com/RocketChat/Rocket.Chat.ReactNative/tree/single-server/ios/RocketChat.xcworkspace) on Xcode 26.x. 2. On the General tab, select “RocketChat” and change **Display Name**, **Bundle Identifier**, **Version,** and **Build**. ![](https://cdn.us.document360.io/27ca1fd4-36d7-4cde-b4eb-97fc1652954c/Images/Documentation/General Tab.png?sv=2026-02-06&spr=https&st=2026-11-20T17%3A57%3A57Z&se=2026-11-20T18%3A57%3A57Z&sr=b&sp=r&sig=Pw9%2F9K9C2kVx%2B395HCGsFLuQdN6f2J3LZ4NJRPHNYi0%3D) 1. Select **ShareRocketChatRN** and **NotificationService** and change the same properties. ![](https://cdn.us.document360.io/27ca1fd4-36d7-4cde-b4eb-97fc1652954c/Images/Documentation/Version and Build.png?sv=2026-02-06&spr=https&st=2026-11-20T17%3A57%3A57Z&se=2026-11-20T18%3A57%3A57Z&sr=b&sp=r&sig=L9wDBBj5m5PzKRmpJ3gSZtz%2Fh55OH4w7ouREX0ZzCFk%3D) 1. `Display Name` and `Bundle Identifier` are different from the previous target 2. `Version` and `Build` must be the same on all targets 2. On Signing and Capabilities for **RocketChat**, check **Automatically manage signing**, select your app group, and add a keychain group: ![](https://cdn.us.document360.io/27ca1fd4-36d7-4cde-b4eb-97fc1652954c/Images/Documentation/Signing.png?sv=2026-02-06&spr=https&st=2026-11-20T17%3A57%3A57Z&se=2026-11-20T18%3A57%3A57Z&sr=b&sp=r&sig=i%2FBO%2BAHNJjk3ZC8KMSFGhgEbvwJWwKjZNjjgZ4aFuwM%3D) Similarly, on the **ShareRocketChatRN** and **NotificationService** targets, check **Automatically manage signing**, select your app group, and add the same keychain group. 3. Set the same app group on `RocketChatRN/Info.plist`, `ShareRocketChatRN/Info.plist` and `NotificationService/Info.plist` ![](https://cdn.us.document360.io/27ca1fd4-36d7-4cde-b4eb-97fc1652954c/Images/Documentation/Information Property List.png?sv=2026-02-06&spr=https&st=2026-11-20T17%3A57%3A57Z&se=2026-11-20T18%3A57%3A57Z&sr=b&sp=r&sig=V8CPsAwCjQeGkI2GRGpKYvp%2B98J%2FKWvr679HlCJZ%2F3g%3D) ![](https://cdn.us.document360.io/27ca1fd4-36d7-4cde-b4eb-97fc1652954c/Images/Documentation/RNInfolist.png?sv=2026-02-06&spr=https&st=2026-11-20T17%3A57%3A57Z&se=2026-11-20T18%3A57%3A57Z&sr=b&sp=r&sig=el6I1%2BokEdfMNZGKay8ngD6TZdd1zGtrJmkmjKd0isg%3D)![](https://cdn.us.document360.io/27ca1fd4-36d7-4cde-b4eb-97fc1652954c/Images/Documentation/Share Info List.png?sv=2026-02-06&spr=https&st=2026-11-20T17%3A57%3A57Z&se=2026-11-20T18%3A57%3A57Z&sr=b&sp=r&sig=cIdLTsN6UV%2FEoROuR6Kav4aSKC9JaAYJ6OpEkHqy0Oo%3D) 1. Set the same keychain group on `RocketChatRN/Info.plist`, `ShareRocketChatRN/Info.plist` and `NotificationService/Info.plist` ![](https://cdn.us.document360.io/27ca1fd4-36d7-4cde-b4eb-97fc1652954c/Images/Documentation/keychain-RN.png?sv=2026-02-06&spr=https&st=2026-11-20T17%3A57%3A57Z&se=2026-11-20T18%3A57%3A57Z&sr=b&sp=r&sig=pNsH2RrInkViPio1cneC0J8B2AliZryb%2B2wZpglTIGE%3D) ![](https://cdn.us.document360.io/27ca1fd4-36d7-4cde-b4eb-97fc1652954c/Images/Documentation/keychain-NS.png?sv=2026-02-06&spr=https&st=2026-11-20T17%3A57%3A57Z&se=2026-11-20T18%3A57%3A57Z&sr=b&sp=r&sig=XKGSmrClcCR7LC%2BMYkNOcFGKlnNnwozoftTgw35689k%3D) ![](https://cdn.us.document360.io/27ca1fd4-36d7-4cde-b4eb-97fc1652954c/Images/Documentation/keychain-SRN.png?sv=2026-02-06&spr=https&st=2026-11-20T17%3A57%3A57Z&se=2026-11-20T18%3A57%3A57Z&sr=b&sp=r&sig=7LNRUNiMIXHQvJf0kLqeYP4FgQPE%2Ba1dRjsOR%2BXhfpk%3D) 1. It needs to be the same on all entitlements. ![](https://cdn.us.document360.io/27ca1fd4-36d7-4cde-b4eb-97fc1652954c/Images/Documentation/RNentitlement.png?sv=2026-02-06&spr=https&st=2026-11-20T17%3A57%3A57Z&se=2026-11-20T18%3A57%3A57Z&sr=b&sp=r&sig=DAi%2FlthH4FzaW0vcuwN59sYH63UHJxh%2FxigbPc%2FLKSE%3D) ![](https://cdn.us.document360.io/27ca1fd4-36d7-4cde-b4eb-97fc1652954c/Images/Documentation/SRNentitlement.png?sv=2026-02-06&spr=https&st=2026-11-20T17%3A57%3A57Z&se=2026-11-20T18%3A57%3A57Z&sr=b&sp=r&sig=l7JjRp2Fg058Zg5Hi8LX%2FOGjMgo5XG8frA0sYAb7GQ8%3D) ![](https://cdn.us.document360.io/27ca1fd4-36d7-4cde-b4eb-97fc1652954c/Images/Documentation/NSentitlement.png?sv=2026-02-06&spr=https&st=2026-11-20T17%3A57%3A57Z&se=2026-11-20T18%3A57%3A57Z&sr=b&sp=r&sig=9k8tE1XmLPBrHarrOd3gCQpsuOPYO5VPS9b5whv2ODM%3D) 1. Change the app icon on `RocketChatRN/Assets/App Icon`: ![](https://cdn.us.document360.io/27ca1fd4-36d7-4cde-b4eb-97fc1652954c/Images/Documentation/AppIcon.png?sv=2026-02-06&spr=https&st=2026-11-20T17%3A57%3A57Z&se=2026-11-20T18%3A57%3A57Z&sr=b&sp=r&sig=6tekxrw3oKpn%2BhB9UL2VK6z5%2BNfazvS8WdVttG4YmSg%3D) 1. Change the app splash screen on `RocketChatRN/Assets/Launch Screen Icon` : ![](https://cdn.us.document360.io/27ca1fd4-36d7-4cde-b4eb-97fc1652954c/Images/Documentation/LaunchScreen(1).png?sv=2026-02-06&spr=https&st=2026-11-20T17%3A57%3A57Z&se=2026-11-20T18%3A57%3A57Z&sr=b&sp=r&sig=19qXgC%2BnWJAT4mQmGSVzFfahXCHSq21Pc7cVHC1G7sA%3D) 2. Change the splash background colors on `RocketChatRN/Assets/splashBackgroundColor` : ![](https://cdn.us.document360.io/27ca1fd4-36d7-4cde-b4eb-97fc1652954c/Images/Documentation/splashbackground(1).png?sv=2026-02-06&spr=https&st=2026-11-20T17%3A57%3A57Z&se=2026-11-20T18%3A57%3A57Z&sr=b&sp=r&sig=P3Z0QscpWynyV9duf2qNe5YQbLnuPNsETtCbSpaoubA%3D) 3. Set your Bugsnag API key on `RocketChatRN/Info.plist` ![](https://cdn.us.document360.io/27ca1fd4-36d7-4cde-b4eb-97fc1652954c/Images/Documentation/bugsnag(1).png?sv=2026-02-06&spr=https&st=2026-11-20T17%3A57%3A57Z&se=2026-11-20T18%3A57%3A57Z&sr=b&sp=r&sig=zEPF1eZSMMT%2BW1yziEGntoDH6hFxgRRF7nrPQ%2F%2FG6Lg%3D) ## Generate iOS app on Firebase 1. Visit the project overview on your [Firebase console](https://console.firebase.google.com). 2. Go to **Settings** > **Project settings**. ![](https://cdn.us.document360.io/27ca1fd4-36d7-4cde-b4eb-97fc1652954c/Images/Documentation/image(27).png?sv=2026-02-06&spr=https&st=2026-11-20T17%3A57%3A57Z&se=2026-11-20T18%3A57%3A57Z&sr=b&sp=r&sig=2cjZ16JnUKj%2FmJ7KULyVyN2WFljsXMO4TcpWIcfUgyU%3D) 3. On the “**General**” tab, click on “**iOS**” button under “**Your apps**” section: ![](https://cdn.us.document360.io/27ca1fd4-36d7-4cde-b4eb-97fc1652954c/Images/Documentation/image(28).png?sv=2026-02-06&spr=https&st=2026-11-20T17%3A57%3A57Z&se=2026-11-20T18%3A57%3A57Z&sr=b&sp=r&sig=dqr0U7hS9kwDswv4X0T3fwFnEYc0CKnPaonwKWbpduw%3D) 4. Enter your **bundle ID** and then “**Register app**”: ![](https://cdn.us.document360.io/27ca1fd4-36d7-4cde-b4eb-97fc1652954c/Images/Documentation/image(29).png?sv=2026-02-06&spr=https&st=2026-11-20T17%3A57%3A57Z&se=2026-11-20T18%3A57%3A57Z&sr=b&sp=r&sig=YWi4aAeqAXkmjQOgD3FU9sjAyS%2FwzGbbl91GzGSSy94%3D) 5. Download the config file and move it as instructed: ![](https://cdn.us.document360.io/27ca1fd4-36d7-4cde-b4eb-97fc1652954c/Images/Documentation/image(30).png?sv=2026-02-06&spr=https&st=2026-11-20T17%3A57%3A57Z&se=2026-11-20T18%3A57%3A57Z&sr=b&sp=r&sig=VCMk89YOQ7RshKXKByAjL5mtf4lJLGnUs9%2BI2mgM8dA%3D) 6. Add it to all targets: ![](https://cdn.us.document360.io/27ca1fd4-36d7-4cde-b4eb-97fc1652954c/Images/Documentation/image(31).png?sv=2026-02-06&spr=https&st=2026-11-20T17%3A57%3A57Z&se=2026-11-20T18%3A57%3A57Z&sr=b&sp=r&sig=cK6tups%2FgrBliaW9SX9ON68sDoVIgvM%2BdTE1jgXs1k0%3D) ## Run the app Execute the following in the project terminal: ```bash pnpm install pnpm pod-install pnpm ios ``` ## Configure the Apple developer portal ### Login to Apple developer portal 1. Visit your [Apple developer account](https://developer.apple.com/account). 2. Enter your credentials. 3. Click **Certificates, Identifiers & Profiles**. ![](https://cdn.us.document360.io/27ca1fd4-36d7-4cde-b4eb-97fc1652954c/Images/Documentation/image(32).png?sv=2026-02-06&spr=https&st=2026-11-20T17%3A57%3A57Z&se=2026-11-20T18%3A57%3A57Z&sr=b&sp=r&sig=CBcLClO5%2FSBCZOT8NDqHEkbW0dTURZO4L%2B6K23RU6kY%3D) ### Create an app identifier 1. Visit the [Apple identifier list](https://developer.apple.com/account/resources/identifiers/list). 2. Click to add **identifier**. 3. Select **App IDs** and click **Continue**. ![](https://cdn.us.document360.io/27ca1fd4-36d7-4cde-b4eb-97fc1652954c/Images/Documentation/image(33).png?sv=2026-02-06&spr=https&st=2026-11-20T17%3A57%3A57Z&se=2026-11-20T18%3A57%3A57Z&sr=b&sp=r&sig=RgZm3d6lAh5kpRr3LNDmc%2B16UFQRXsUE3rwOgy37OXI%3D) 4. Add a **Description** and **Bundle ID**: ![](https://cdn.us.document360.io/27ca1fd4-36d7-4cde-b4eb-97fc1652954c/Images/Documentation/image(34).png?sv=2026-02-06&spr=https&st=2026-11-20T17%3A57%3A57Z&se=2026-11-20T18%3A57%3A57Z&sr=b&sp=r&sig=9S2GcUb5V2S66HFIwqv4UZBNrh2HE7ebZOzYcAQMLaA%3D) 5. On **Capabilities**, select **App Groups** and **Push notifications**. 6. Click **Continue** and then **Register**. ### Create an app identifier for the share extension version 1. Share extension is a version of the app that opens when you share data from another app to Rocket.Chat. For example, share a photo from the gallery. 2. Visit the [resources identifier list](https://developer.apple.com/account/resources/identifiers/list). 3. Click to add **Identifier**. 4. Select **App IDs** and **Continue**. ![](https://cdn.us.document360.io/27ca1fd4-36d7-4cde-b4eb-97fc1652954c/Images/Documentation/image(35).png?sv=2026-02-06&spr=https&st=2026-11-20T17%3A57%3A57Z&se=2026-11-20T18%3A57%3A57Z&sr=b&sp=r&sig=tDxRR7qnQ6OInTteCcUR93Wvvd2mmNpggh%2B%2BmBgJN1c%3D) 5. Add a **description** and **Bundle ID**. ![](https://cdn.us.document360.io/27ca1fd4-36d7-4cde-b4eb-97fc1652954c/Images/Documentation/image(36).png?sv=2026-02-06&spr=https&st=2026-11-20T17%3A57%3A57Z&se=2026-11-20T18%3A57%3A57Z&sr=b&sp=r&sig=mGoQxZfiBd8uJuMDBIVyN9v61CU2YnQctYok5exTNno%3D) 6. This time, select only **App Groups** under **Capabilities**. 7. Click **Continue** and then **Register**. ### Create an app identifier for our notification service ![](https://cdn.us.document360.io/27ca1fd4-36d7-4cde-b4eb-97fc1652954c/Images/Documentation/image(37).png?sv=2026-02-06&spr=https&st=2026-11-20T17%3A57%3A57Z&se=2026-11-20T18%3A57%3A57Z&sr=b&sp=r&sig=BgW9u9gI0YuDaXvOVsUsmGRt2MC0CxSFhXD0ewOLMGE%3D) ### Create an app group 1. Visit the [resources identifier list](https://developer.apple.com/account/resources/identifiers/list). 2. Click to add **Identifier**. 3. Select **App Groups** and **Continue**. ![](https://cdn.us.document360.io/27ca1fd4-36d7-4cde-b4eb-97fc1652954c/Images/Documentation/image(38).png?sv=2026-02-06&spr=https&st=2026-11-20T17%3A57%3A57Z&se=2026-11-20T18%3A57%3A57Z&sr=b&sp=r&sig=LDcE6zzpihJzZMpJqmOE9maaL7H%2Fvm57hdAh0zJwK8U%3D) 4. Enter a **Description** and an **Identifier**: ![](https://cdn.us.document360.io/27ca1fd4-36d7-4cde-b4eb-97fc1652954c/Images/Documentation/image(39).png?sv=2026-02-06&spr=https&st=2026-11-20T17%3A57%3A57Z&se=2026-11-20T18%3A57%3A57Z&sr=b&sp=r&sig=Y140xo2Jb2Y%2B9iYAsJHL8YYQO7m%2B9eG%2BkixzaRAhSBE%3D) 5. Click **Continue** and then **Register**. ### Apply app group 1. Visit the [resources identifier list](https://developer.apple.com/account/resources/identifiers/list). 2. Click on the first identifier you created. 3. On **App Groups**, click **Configure**. 4. Select the **App Group** you created and click **Continue**. 5. Click **Save**. 6. Repeat these steps for the second identifier you created for the Share Extension and notification service. ### Create push notifications certificates - Visit the [resources identifier list](https://developer.apple.com/account/resources/identifiers/list). - Click on the first identifier you created. - On **Push Notifications**, click **Configure**. ![](https://cdn.us.document360.io/27ca1fd4-36d7-4cde-b4eb-97fc1652954c/Images/Documentation/image(40).png?sv=2026-02-06&spr=https&st=2026-11-20T17%3A57%3A57Z&se=2026-11-20T18%3A57%3A57Z&sr=b&sp=r&sig=xtXMlnnZd1H5zVKOFhKim1wEcLeftaxZPF8nQpLK394%3D) #### Development SSL Certificate 1. On **Development SSL Certificate**, click **Create Certificate**. 2. Follow the [official tutorial](https://help.apple.com/developer-account/#/devbfa00fef7) to generate a **Certificate Signing Request**. 3. Select the certificate you created and click **Continue**. ![](https://cdn.us.document360.io/27ca1fd4-36d7-4cde-b4eb-97fc1652954c/Images/Documentation/image(41).png?sv=2026-02-06&spr=https&st=2026-11-20T17%3A57%3A57Z&se=2026-11-20T18%3A57%3A57Z&sr=b&sp=r&sig=6fNk69uld5hgOEiSrqKDXGbp%2BuTme9Mngz8SjGK94kU%3D) 4. Download the certificate and install it on your machine per the on-screen instructions. ![](https://cdn.us.document360.io/27ca1fd4-36d7-4cde-b4eb-97fc1652954c/Images/Documentation/image(42).png?sv=2026-02-06&spr=https&st=2026-11-20T17%3A57%3A57Z&se=2026-11-20T18%3A57%3A57Z&sr=b&sp=r&sig=WcFf%2FjqyMWgoe8goKI6JkMXf%2B%2BTVwmXfGBoK3ii2qUI%3D) 5. After installing it, **Keychain Access** should have opened automatically on your Mac. 6. Export the certificate to generate a `.p12` file. ![](https://cdn.us.document360.io/27ca1fd4-36d7-4cde-b4eb-97fc1652954c/Images/Documentation/image(43).png?sv=2026-02-06&spr=https&st=2026-11-20T17%3A57%3A57Z&se=2026-11-20T18%3A57%3A57Z&sr=b&sp=r&sig=m%2B5mFHYDDDCrseCOXAqdKKGt4K%2Fv6Tfm0LBz0PpHsl8%3D) 7. For simplicity, save it in the same folder of your CSR and `.cer`. You’ll need it later for SSL/TLS authentication and encryption. #### Production SSL Certificate 1. On **Production SSL Certificate**, click **Create Certificate**. 2. Follow the [official tutorial](https://help.apple.com/developer-account/#/devbfa00fef7) to generate a **Certificate Signing Request**. 3. Select the certificate you created and click **Continue**. ![](https://cdn.us.document360.io/27ca1fd4-36d7-4cde-b4eb-97fc1652954c/Images/Documentation/image(44).png?sv=2026-02-06&spr=https&st=2026-11-20T17%3A57%3A57Z&se=2026-11-20T18%3A57%3A57Z&sr=b&sp=r&sig=iHORIcIFzWf%2FNDYHiXZDjBIc3ZtRDEW7WuxWMIjYSdE%3D) 4. Download the certificate and install it on your machine per the on-screen instructions. ![](https://cdn.us.document360.io/27ca1fd4-36d7-4cde-b4eb-97fc1652954c/Images/Documentation/image(45).png?sv=2026-02-06&spr=https&st=2026-11-20T17%3A57%3A57Z&se=2026-11-20T18%3A57%3A57Z&sr=b&sp=r&sig=4sG%2FoyV1TtuCyeaNimoe595LaKxF46Y0M%2FLosz2xT0c%3D) 5. After installing it, **Keychain Access** should have opened automatically on your Mac. 6. Export the certificate to generate a `.p12` file ![](https://cdn.us.document360.io/27ca1fd4-36d7-4cde-b4eb-97fc1652954c/Images/Documentation/image(46).png?sv=2026-02-06&spr=https&st=2026-11-20T17%3A57%3A57Z&se=2026-11-20T18%3A57%3A57Z&sr=b&sp=r&sig=0pHWN2WTVuAMPFSBLF7iYgX7bGJT8UvGs4GuKFrWdak%3D) 7. For simplicity, save it in the same folder as your CSR and `.cer`. You’ll need it later for SSL/TLS authentication and encryption. 8. Refer to the [Configuring Push Notifications](/v1/docs/configuring-push-notifications) document for further details on setting up push notifications.