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
Navigate to the VR Content tab.
Press the Add Content button.
Click the Select .apk box or drag and drag an APK file into this drop zone.
If the APK file has an accompanying OBB file, add this to the Select .obb box.
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:
Navigate to the VR Content tab
Select the app you wish to update
Click the Select .apk box or drag and drop an APK file into the designated drop zone for app versions
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
Log in to your ManageXR Dashboard.
Navigate to VR Content → Apps in the left sidebar.
Find and click the app you want to update.
Click on the App Icon section, or hover over existing icon to replace it.
Select your custom image file and click Open.
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
You can also read our related guide: Troubleshooting: I can’t see my application thumbnails or logos inside the ManageXR Home Screen