Learn how to manage your bundle IDs and resolve setup issues in the 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 protect your license from unauthorized use.
Depending on your platform, bundle identifiers can be:
-
Web: Hostnames or IP addresses (e.g.,
localhost
,editor.yoursite.com
) -
Mobile (iOS/Android): App bundle names (e.g.,
com.yourcompany.app
) -
They can include characters, numbers, dashes, or wildcards (e.g.,
*.img.ly
)
How to add or update your bundle IDs?
-
Log In to Your Dashboard: Head to your IMG.LY dashboard and log in.
-
Scroll down to your subscription: Find the one to work with, and click Edit on Bundle IDs / Hostnames.
-
Add or Edit Bundle IDs
-
Add your bundle IDs, separating them with commas.
Example:com.yourcompany.app1,com.yourcompany.app2
For web:editor.yoursite.com,localhost,*sub.yoursite.com
-
-
Save your changes
Click Save, then download or copy the updated license file and integrate it into your project.
Common Error: "Invalid app bundle identifiers"
This error typically means there’s a mismatch between your configured bundle ID and the actual hostname or app ID.
Web (CE.SDK)
-
Make sure the bundle ID matches the value of
window.location.hostname
. -
Use
localhost
while developing locally. -
You can use wildcards (e.g.,
*.img.ly
) to allow multiple subdomains. -
Avoid using
www.
as a prefix in the bundle ID — it can cause mismatches.
iOS / Android (PV/E.SDK)
-
Ensure the Bundle ID matches your app’s bundle exactly.
-
If you're seeing this error, double-check the ID used during integration.
Quick Fix Steps:
-
Update your bundle IDs: Remove the
www.
prefix or adjust the hostname/app ID as needed. -
Download a new license: After making changes, download a fresh license file from the dashboard.
-
Reintegrate it: Replace the old license file in your project with the new one.
💡 Note: If you're working with a Flutter web view, this does not affect the standard JS integration for the PhotoEditor SDK.
Any issues or additional questions? Our support team is here to assist. Submit a support request, and we’ll help you resolve it quickly and smoothly.