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:
- Log in to your IMG.LY dashboard
- 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 ofwww.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.