> ## Documentation Index
> Fetch the complete documentation index at: https://docs.reyapp.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Register a Bundle ID for Your Rey App

> Create a unique Bundle ID in your Apple Developer account so Apple can identify your Rey app across the App Store, App Store Connect, and iCloud services.

Every iOS app needs a unique **Bundle ID** — a reverse-DNS string like `com.reylabs.myapp` — that Apple uses to identify your app across the App Store, App Store Connect, provisioning profiles, and services like Push Notifications and iCloud.

You register the Bundle ID **once** in your Apple Developer account, then reference it when you create your app listing in App Store Connect.

## Prerequisites

* An active [Apple Developer Program membership](/publishing/app-stores/app-store/apple-developer-account).
* A chosen Bundle ID string (see naming rules below).

## Choose a Bundle ID

Bundle IDs follow **reverse-DNS notation** and must be globally unique across all of Apple's ecosystem.

<AccordionGroup>
  <Accordion title="Format and rules">
    * Lowercase letters, numbers, and dots. Hyphens are allowed but not conventional.
    * Reverse-DNS style: start with your domain in reverse, then the app name. Example: `com.reylabs.taskflow`.
    * Must be unique across all of Apple's registered Bundle IDs — you cannot reuse one another developer has claimed.
    * **Cannot be changed** after your app is submitted to the App Store, so pick carefully.
  </Accordion>

  <Accordion title="Good examples">
    * `com.acme.notes`
    * `io.reyapp.taskflow`
    * `com.yourcompany.yourapp`
  </Accordion>

  <Accordion title="Bad examples">
    * `MyApp` — not reverse-DNS.
    * `com.apple.myapp` — you cannot use Apple's namespace.
    * `com.acme.notes.v2` — don't include version numbers.
  </Accordion>
</AccordionGroup>

<Warning>
  Choose your Bundle ID carefully. It cannot be changed once your app is submitted to the App Store, and it must match the identifier you configure in Rey.
</Warning>

## Register the Bundle ID

<Steps>
  <Step title="Sign in to the Apple Developer portal">
    Go to [developer.apple.com/account](https://developer.apple.com/account) and sign in with the Apple ID tied to your developer account.
  </Step>

  <Step title="Open Identifiers">
    In the sidebar, click **Certificates, Identifiers & Profiles**, then click **Identifiers**.
  </Step>

  <Step title="Add a new identifier">
    Click the **+** button next to “Identifiers”. Choose **App IDs**, then click **Continue**.
  </Step>

  <Step title="Choose the App type">
    Select **App** (the default) and click **Continue**.
  </Step>

  <Step title="Enter a description and Bundle ID">
    * **Description**: A human-readable name, e.g. `TaskFlow production app`. This is for your reference only.
    * **Bundle ID**: Choose **Explicit** and enter your reverse-DNS Bundle ID (e.g. `com.reylabs.taskflow`).
  </Step>

  <Step title="Select capabilities (optional)">
    Enable any Apple services your app uses — for example **Push Notifications**, **Sign in with Apple**, or **iCloud**. You can enable more later.
  </Step>

  <Step title="Register the identifier">
    Click **Continue**, review the details, then click **Register**. Your Bundle ID is now reserved and ready to use.
  </Step>
</Steps>

## Add the Bundle ID to Rey

<Steps>
  <Step title="Open Publish settings in Rey">
    In the Rey editor, click **Publish** in the toolbar and select **App Store** as the target.
  </Step>

  <Step title="Paste your Bundle ID">
    In the **iOS settings** section, paste the exact Bundle ID you registered in the Apple Developer portal.
  </Step>

  <Step title="Save">
    Rey uses this Bundle ID when it signs and submits your build. It must match your Apple Developer identifier exactly — typos will cause the submission to fail.
  </Step>
</Steps>

## Next steps

* [Register your first app in App Store Connect](/publishing/app-stores/app-store/register-first-app) using the Bundle ID you just created.
* Return to the [Publish to App Store overview](/publishing/app-stores/app-store/overview) for the full submission walkthrough.