Skip to main content

Upload a Managed App

Add a managed app to ManageXR

Westley Heagy avatar
Written by Westley Heagy
Updated over a week ago

With ManageXR, you can deploy any application to your device. To do this, you must first upload an application to your ManageXR app library. Once in your library, you can deploy your content via configurations.

Upload a Managed App

  1. Navigate to the VR Content tab.

  2. Press the Add Content button.

  3. Click the Select .apk box or drag and drag an APK file into this drop zone.

  4. If the APK file has an accompanying OBB file, add this to the Select .obb box.

  5. Click Create App.

Once uploaded, the new app will be available in your app library and can be distributed via a configuration. If you're uploading your app to share with many clients or other ManageXR organizations, you may want to use Release Channels to assist in app deployment. Then, as your app evolves, rather than updating each of your configurations with the new version, you can instead update the app's Release Channel.

Upload New Version of a Managed App

When uploading a new app version, make sure to follow the guidelines described in our App Versioning documentation. You can also use the ManageXR CLI to automate the process of uploading applications to ManageXR.

To upload a new version:

  1. Navigate to the VR Content tab

  2. Select the app you wish to update

  3. Click the Select .apk box or drag and drop an APK file into the designated drop zone for app versions

  4. Click Add Version

Upload a Custom App Thumbnail or Icon

When you upload an app to ManageXR, we’ll automatically try to extract the app’s icon from the APK or app bundle. However, the icon pulled from your app may be low resolution or not appear correctly on the ManageXR Home Screen.

To ensure your app looks its best, you can upload a custom thumbnail or icon after the app has been added to your library.


Recommended Image Specs

Setting

Recommendation

Size

256×256 pixels (preferred) — up to 512×512 pixels maximum

File type

PNG or JPG

Color mode

RGB (CMYK images may not display correctly)

File size

Under 5 MB

If you use the ManageXR Home Screen, we strongly recommend uploading a high-resolution icon for each app. This ensures your content looks crisp and consistent across all devices.

Uploading a Custom App Icon

  1. Log in to your ManageXR Dashboard.

  2. Navigate to VR Content → Apps in the left sidebar.

  3. Find and click the app you want to update.

  4. Click on the App Icon section, or hover over existing icon to replace it.

  5. Select your custom image file and click Open.

  6. Once uploaded, click Save Changes at the to right of the page.

Your new app icon will immediately replace the automatically generated one. It will also appear on the ManageXR Home Screen, within the dashboard, and in any configurations where that app is displayed.

Using Different Icons per Configuration (Optional)

If you’d like to show different app icons or thumbnails across configurations, for example, to match branding for different clients or locations, you can use Home Screen Content Overrides. These overrides applies only to the selected configuration. Your original app icon will remain unchanged in the main library.

Troubleshooting

If you're having issues uploading an app while using Safari or Firefox web browsers, please try using Chrome. If your uploaded icon:

  • Appears blank or black

  • Looks stretched or low-quality

  • Doesn’t display on the Home Screen

Check the following:

  • The file is PNG or JPG in RGB color mode

  • The dimensions are at least 256×256 pixels

  • You’ve clicked Save Changes after uploading

Did this answer your question?