What Is a Bundle ID?

Every iOS app requires an "App ID" to work. This is a string that is set up during development, usually in the form of com.your-company.app-name. Please note that "App ID" and "Bundle ID" is generally used interchangeably.

PSPDFKit usually bases the license on such a Bundle ID, and for licensing this has to be an explicit ID, meaning an ID that is unique and does not contain a star (*) value.

Once a Bundle ID is registered in the PSPDFKit license portal, it can't be changed anymore. Careful: IDs are case sensitive, so make sure you register the correct case variant.

You can learn more about wildcard App ID vs. an explicit App IDs here.

There is generally no limitation from Apple on how many App IDs you can create in the Apple Developer Portal. End users do not see this ID, unless they are technically very advanced and manually open your App Bundle.

See Finding an iOS App's Bundle Identifier article if you are unsure about the Bundle ID of your app.

Development and Testing

For development and testing, you can request additional Bundle IDs from our license portal. Please ensure that you registered the actual Bundle ID beforehand, and that the beta/testing id is recognizable as such.

Example: Your product is named "FaxSender" and your company name is "OKBX Corporation". Your Bundle ID usually will look like this: com.okbx.fax-sender Your testing IDs can be: com.okbx.fax-sender.dev, com.okbx.fax-sender.staging, com.okbx.fax-sender.testing or com.okbx.fax-sender.beta.

We approve these IDs manually and will add them if they approximately match the above testing scheme. If you have a different scheme, please add a comment and we will consider these changes.

If you can't find the "Request Beta ID" link, you either have no license entry yet (payment open?) or haven't yet registered your actual Bundle ID with that license. Please do so and the Beta ID request feature will work.

Enterprise Considerations

If you distribute your app in multiple enterprise app stores, it would be technically possible to use the same App ID in multiple stores. However, this loophole is closed by our license agreement. If you need to deploy your applications in multiple stores, please contact us so we can figure out a solution.

iOS Extensions (App Extensions, Notification Widgets)

App Extensions are a new feature in iOS 8, and these will need a separate Bundle ID. This will require an additional license, however we might be able to offer a discount if you explain your Extension use case. iOS 10 adds Notification Widgets which also require a separate license.