How do I configure my Bundle IDs and fix "Invalid app bundle identifier" errors?

Learn how to manage your bundle IDs and resolve setup issues directly from your IMG.LY dashboard.

What are Bundle IDs?

A Bundle ID is a unique string that identifies your app or web project. All IMG.LY license keys are bound to one or more bundle identifiers to help protect your license from unauthorized use. Make sure to first: 

  1. Log in to your IMG.LY dashboard
  2. Select "Edit" on the desired subscription on your home page in the section "Bundle IDs / Hostnames"

Now, which Bundle Identifier should I use?

Depending on your platform, bundle identifiers can be:

For Web Projects (CE.SDK)

Your bundle ID must match the value of window.location.hostname.

  • Use localhost while developing locally

  • Wildcards are supported, e.g., *.img.ly covers all subdomains

  • Avoid using www. as a prefix; it can cause mismatches

  • Use the bare domain (e.g., example.com instead of www.example.com)

For Mobile Projects (CE.SDK iOS/Android or PE/VE.SDK)

Use your app's unique bundle ID, for example:
com.yourcompany.app

⚠️ Important: If you've already added a hostname, you cannot add an IP address as well. Only one type is allowed per entry.

Can I use multiple bundle identifiers?

Yes! You can add multiple bundle IDs for different environments (e.g., development, staging, production). Just make sure to:

  • Separate each one with a comma ( , )

  • Avoid leaving blank lines

Getting an "Invalid app bundle identifiers" error?

If you're seeing this error, it usually means there's a mismatch between your configured bundle ID and what’s actually being used.

Here’s how to fix it:

  • Double-check that your bundle ID matches window.location.hostname exactly

  • Remove any www. prefix from your entered value

  • Download a new license file after making changes

  • Re-integrate the updated license into your project

💡 Note: If you're working with a Flutter web view, this doesn't affect the standard JS integration for the PhotoEditor SDK.

Still stuck?

If you need any help, we’re happy to support you. Just submit a support request, and we’ll get you sorted out as quickly as possible.