Skip to main content
All CollectionsApp Sharing
Share Apps with Organizations
Share Apps with Organizations
Josh Franzen avatar
Written by Josh Franzen
Updated over a week ago

Who can use this feature?

πŸ‘€ Organizations Owners & Admins.
🚩 Available on all plans.

Overview

ArborXR's app sharing functionality allows app developers to share apps with other organizations effortlessly, using just a few clicks. App developers can share apps with both "internal" organizations where they are a user and "external" organizations to which they do not have direct access.

Benefits:

  • For App Developers: App sharing enables app developers to upload app builds once to their organization and then easily share them with one or more of their client's organizations. This simplifies application and version management while allowing the client to handle the deployment of the shared apps to their devices.

  • For Enterprises & Educational Institutions: For enterprises or educational institutions that source content from multiple external app developers, each of their content providers can securely share apps with their organization. This allows app developers to manage applications and versions, while the enterprise or educational institution can manage the installation of these applications to their devices.


Steps to Share Apps

Method 1: Share a Single App

  1. Navigate to Content Library in the side navigation menu.

  2. Click on the app that you would like to share.

  3. Select the Sharing tab.

  4. Click Share.

  5. Select the Release Channel(s) for the app you wish to share.
    ​

    • Select the Release Channel(s) that you want to share, which will share the current Target Version for that channel

    • At any time after you've shared the channel, once updating the Target Version of the Release Channel, all organizations you've shared your channel with will update automatically to the new Target Version

      • If you've shared a Release Channel that targets Latest, then it will automatically update its Target Version to the latest version of the app.

  6. Click on the Organization(s) input:

    • Share with "internal" organizations where you are a user by selecting them within the dropdown.

    • Share with "external" organizations to which you do not have direct access by entering the external organization's slug. You can paste multiple organization slugs to share with multiple external organizations simultaneously.
      ​


      ⚠️ The target recipient organization will need to provide you with their organization slug. They can find their organization slug in Organization Settings > Overview > Organization Slug.


  7. Click Share.

Method 2: Share Multiple Apps

  1. Navigate to the Content Library.

  2. Select the applications you wish to share by clicking on the checkbox next to each of the apps.

  3. Select the Edit button, which can be found to the left of the search bar.

  4. Click Share Apps.

  5. By default, the Default Release Channel for each of the selected apps will be shared. To share a Release Channel other than the Default, click on the caret icon to open a pop-up and then select the desired Release Channel.
    ​

  6. In the Select Organization input:

    • Share with "internal" organizations where you are a user by selecting them within the dropdown.

    • Share with "external" organizations to which you do not have direct access by entering the external organization's slug. You can paste multiple organization slugs to share with multiple external organizations simultaneously.
      ​


      ⚠️ The target recipient organization will need to provide you with their organization slug. They can find their organization slug in Organization Settings > Overview > Organization Slug.


  7. Click Share.

πŸ’‘ Multiple release channels cannot be shared when sharing multiple apps at once. To share multiple release channels, refer to method 1 above.


Steps to Revoke Shared Apps

  1. Navigate to Content Library in the side navigation menu.

  2. Click on the app that you would like to share.

  3. Select the Sharing tab..

  4. Select the organization(s) you would like to revoke access from.

  5. Click Revoke Access.

  6. Click Yes, Revoke.

πŸ’‘ While multiple apps can be shared at once, currently it is not possible to revoke multiple apps at once.


FAQs

What is the difference between an "internal" organization and an "external" organization?

  • An "internal" organization is an organization you have access to. When sharing apps, you will see a dropdown of all of the organizations you have access to.

  • An "external" organization is an organization to which you do not have direct access. In order to share an application with an external organization, you must enter the external organization's slug. The target recipient organization will need to provide you with their organization slug. They can find their organization slug in Organization Settings > Overview > Organization Slug.

How do organizations accept shared apps?

Apps shared with "internal" organizations:

Apps shared with internal organizations are immediately shared and available in the recipient organization's Apps page. An email notification will not be sent.

Apps shared with "external" organizations:

  1. Organization Owners and Admins from the receiving organization will receive an email notifying them that the app was shared.

  2. Organization Owners and Admins from the receiving organization can click on the link provided in the email, or manually navigate to the Pending tab of their Apps page, where they can then Add To Library or Decline.

As the organization sharing an app, what happens when I upload a new version of the app?

It depends on which Release Channel is shared with the organization:

  • Latest Release Channel

    • If you've shared a Release Channel that targets Latest, then it will automatically update its Target Version to the newly uploaded version provided it's of a higher versionCode.

  • Any other Release Channel

    • Any other Release Channel that's not Latest will not be affected until you manually change the Release Channel's Target Version.

Can I track the number of devices that my shared apps are installed on?

Yes. Navigate to the Analytics page then select the Shared Apps tab.

The Shared Apps tab displays all organizations that apps have been shared with along with the number of devices that each shared app has been installed on. The Shared Apps table can be sorted by recipient organization or by shared app.

Can recipient organizations download the shared .apk file to their PC, edit the shared app's name or upload new versions?

When an app is shared, the recipient organization:

  • Cannot downloaded the .apk file. Shared apps can be installed to devices but can't be downloaded or redistributed.

  • Cannot change the app name. The name of shared apps as set by the sharing organization can't be changed.

  • Can change the description. The description of shared apps can be edited to better fit organizational context.

  • Can add tags. Tags can be added to shared apps for better organization, searchability, and filtering content in ArborXR Home.

What happens when the organization that shared the app revokes access?

Apps shared with "internal" organizations:

If an app that was shared to an internal organization is revoked by the organization that shared it:

  • Email notifications will not be sent and the app will immediately be removed from the recipient organization's Apps page

  • The app will be queued to uninstall on devices that have the shared app installed

Apps shared with "external" organizations:

If an app shared to an external organization is revoked by the organization that shared it:

  • Organization Owners and Admins from the receiving organization will receive an email notifying them that the app was revoked
    ​

  • The app will immediately be removed from the recipient organization's Apps page

  • The app will be queued to uninstall on devices that have the shared app installed

Did this answer your question?