Share from Apps in your OpenCX dashboard: open the app card’s menu and choose Share. Changing who can open an app requires Roles settings Write and edit access to the app.
Find apps in the library
Apps shows a different library depending on your role:- Authors (Mini apps Write) see every app, grouped into Dashboard apps and Inbox widgets, with search and filters for Status (All, Live, Drafts), Owner and Tag. Each card shows the live version (v3), Draft, or No build. The card menu offers Open, and on apps you can edit, Share, Edit details and Delete.
- Everyone else sees the published apps they can open. Members with Mini apps Read can open every published app.
Share an app with roles
Sharing works by role. An app with no roles selected stays private to admins and members with the Mini apps permission.1
Open Share
In Apps, open the app card’s menu and choose Share. In the preview, the Share icon appears when the live version is selected.
2
Pick roles under Can open
Select the roles whose members can open the app. Changes save immediately.
3
Limit an inbox widget to channels (optional)
For an inbox widget, the channel picker at the end of the row limits the channels it shows on. Leave it empty for every channel.
Dashboard apps open in Companion, so the member’s role also needs Companion or Mini apps Read. Inbox widgets don’t need either.
Control who can edit
Mini apps and inbox widgets have an owner and a list of people allowed to edit them. Creating an app makes you its owner. By default, everyone with app edit permission (Mini apps Write) can edit it. Editing always requires app edit permission in the workspace. An empty editor list allows everyone with that permission. Selecting people restricts editing to those people and the owner. This restriction applies to admins too. Being able to open an app does not grant app edit permission.Invite or remove editors
- Open Apps and choose Share from the app’s menu.
- Under Can edit, leave the picker empty to allow everyone with app edit permission, or select people to restrict editing. The picker includes you as the owner. Select only yourself to allow only you to edit.
- Remove someone from a restricted list to revoke their editing access. Clearing the list allows everyone with app edit permission again. Changes save immediately. The owner always retains access, even when selecting only other people.
Transfer ownership
In Share, choose a teammate under Transfer ownership, then select Transfer ownership. The new owner must have app edit permission. The new owner controls the editor list. Existing editors keep access, including the previous owner. The new owner can remove the previous owner afterward. Transfer ownership before leaving the organization. If the owner has already left, existing editors can keep editing, but ownership recovery requires support.Apps without an owner
Apps created before editor access existed start with an empty editor list, preserving editing for everyone with app edit permission. They are not assigned an owner automatically. Contact support to assign an owner before restricting editors. Published apps remain available to their existing viewers.Editing through connected tools
The same restrictions apply when Companion or a connected tool changes an app. The request must identify the acting user, carry the required access, and, when changing an existing app with a restricted list, come from a selected editor or its owner. A bare API key cannot create or change mini apps, even if its scopes allow app writes. If an edit is refused, ask the owner to add you under Can edit and check your workspace app edit permission. Admin permission alone does not override the list. Companion checks edit access before changing app files or building a new version. If access is denied, it explains that the owner must invite you and leaves the existing app available to open. You can still ask questions about an app you can view.Pin apps to Reports & Apps
Reports & Apps in the sidebar holds one arrangement for the whole workspace: built-in report pages and published dashboard apps. Each person sees only the entries they can open, so someone with a shared app sees the section even without report access. Inbox widgets never appear here. Arranging requires Helpdesk settings Write.- In the sidebar under Reports & Apps, select Add, then pick an app. Report pages are listed above apps.
- Drag rows to reorder them.
- To remove an entry, open its menu and choose Unpin from Reports.
Use inbox widgets
When an inbox widget is published and shared with one of your roles, it appears at the top of Widgets in the session sidebar the next time you open a session. It shows only on the channels selected for it. Your widget pins are your own:- Unpin a widget from its More menu, and bring it back with Add a widget.
- Drag widgets to reorder them.
- Full screen opens a larger view and Reload restarts the widget.
- Edit in the More menu opens the app in Companion, if you can edit it.
What a widget knows about the session
A widget receives the open session, the session’s contact when there is one, and you as the viewer, with your name and email. Opening another session reloads it with that session. Anything else it shows, such as messages or order details, comes through the permissions approved at publish or the actions it runs.Place a widget for everyone with Adjust widgets
With Helpdesk settings Write, on a desktop-size window, you can fix a widget’s spot in the session sidebar for the whole workspace.- Open a session and choose Adjust widgets from the session menu, or from a widget’s More menu.
- Place the widget among the built-in cards, then select Save.
Troubleshooting
Related Documentation
Build and publish
Versions, permissions and domains.
Mini apps introduction
What apps are and who can build them.
Workspace settings
The Reports & Apps sidebar setting.
Roles
Create roles to share apps with.