Skip to content
English
Get in Touch Customer portal Sign in
img.ly
  • There are no suggestions because the search field is empty.

How to configure your Bundle IDs and fix identifier errors?

Every IMG.LY license key is bound to one or more bundle identifiers. This is how IMG.LY protects your license from unauthorized use, ensuring it only runs where you have authorized it to. Before your integration will work, you need to make sure the right identifiers are configured in your dashboard.

How to add or update your Bundle IDs?

Log in to your dashboard at img.ly/dashboard, find the subscription you want to configure, and click Edit in the Bundle IDs / Hostnames section. From there you can add, update, or remove identifiers as needed.

Which identifier to use depending on your platform?

The right value depends on what you are building.

For web projects using CE.SDK, your bundle identifier must match the value of window.location.hostname exactly. A few things to keep in mind:

  • Use localhost when developing locally.
  • Wildcards are supported, so *.img.ly will cover all subdomains under that domain.
  • Do not use www. as a prefix. Use the bare domain instead, for example example.com rather than www.example.com.
  • If you have already added a hostname, you cannot also add an IP address. Only one type is allowed per entry.

For mobile projects using CE.SDK on iOS or Android, or PE.SDK and VE.SDK, use your app's unique bundle identifier, for example com.yourcompany.app.

Using multiple identifiers

You can add more than one bundle identifier to cover different environments such as development, staging, and production. Separate each entry with a comma and avoid leaving any blank lines between them.

What to do if you see an "Invalid app bundle identifier" error?

This error almost always means there is a mismatch between the identifier you configured and what is actually being used at runtime. To resolve it, work through the following:

  • Confirm that your bundle ID matches window.location.hostname exactly.
  • Remove any www. prefix from the value you entered in the dashboard.
  • Download a fresh license file after saving your changes.
  • Re-integrate the updated license file into your project.

If you are working with a Flutter web view, this does not affect the standard JS integration for the PhotoEditor SDK.

If you are still stuck

If none of the above resolves the issue, submit a request through our support form and the team will help you get it sorted out.