diff --git a/content/en/kanvas/designer/sharing/index.md b/content/en/kanvas/designer/sharing/index.md index ddbebe9da55..12dedae4077 100644 --- a/content/en/kanvas/designer/sharing/index.md +++ b/content/en/kanvas/designer/sharing/index.md @@ -15,6 +15,10 @@ In Kanvas, you can share your designs with other members of your organization an You can share and control access to [Views]({{< ref "kanvas/operator/views/index.md" >}}) in the same fashion as you do for Designs. {{< /alert >}} +{{< alert title="Verify People with Access after sharing" type="warning">}} +In some earlier cases, the Share modal could report success while the grant or revoke was not applied. If you shared a design or view and collaborators still cannot open it—or someone you removed still has access—open **Share** on that resource and re-check the **People with Access** list. Re-add anyone who is missing, remove anyone who should not retain access, and confirm that collaborators can open the resource. Always treat **People with Access** as the source of truth after every share. +{{< /alert >}} + ## Understanding visibility levels Designs have visibility statuses that defines who can access your designs. These options offer different levels of exposure for content within your workspaces: @@ -130,5 +134,19 @@ There are two primary ways to share designs with teams: > Learn more about auditing the access permission within [workspace]({{< ref "cloud/concepts/spaces/workspaces.md" >}}) +## Share and visibility notifications + +Kanvas surfaces explicit notifications when a share or visibility action cannot complete. These messages replace earlier silent failures so you can tell success apart from an incomplete request. + +| Situation | What you see | What to do | +| --- | --- | --- | +| You change visibility on a resource kind that does not support a visibility mutation | A notification that the visibility change is **unsupported** for that resource (not a success message) | Keep the resource's current visibility, or use a resource kind that supports Private / Public / Published transitions. | +| You click **Share** while the design or view body is still loading, or after the body failed to load | A notification that **sharing is unavailable** | Wait until the resource finishes loading, then open Share again. If the body failed to load, refresh or reopen the resource and retry once it loads successfully. | +| The Share modal cannot load the access list | A notification that the **access list failed to load**, instead of an empty collaborator list | Close and reopen Share, or refresh the page. Do not assume that an empty list means nobody has access—until the list loads, the owner row and existing grants may be hidden, which also blocks revoke actions. | + +{{< alert title="People with Access is authoritative" type="note">}} +After any grant or revoke, confirm the result in **People with Access** before you rely on the change. A success path updates that list; if the list did not load or the expected user is missing, treat the share as incomplete and retry. +{{< /alert >}} + [^1]: This functionality is not fully implemented yet. Users might occasionally observe that even when a team is assigned to a workspace, members of that team may not be able to access private designs within that workspace without explicit individual or team-level sharing for the design itself. -[^2]: This feature (direct sharing with teams via the "Share" modal) is not yet fully implemented and is planned for a future update. \ No newline at end of file +[^2]: This feature (direct sharing with teams via the "Share" modal) is not yet fully implemented and is planned for a future update. diff --git a/content/en/kanvas/operator/views/index.md b/content/en/kanvas/operator/views/index.md index d990630753b..7df1ff5d31e 100644 --- a/content/en/kanvas/operator/views/index.md +++ b/content/en/kanvas/operator/views/index.md @@ -29,6 +29,9 @@ Here's what you can do with views in Operator: ### 3. Share a view Sharing a view lets you collaborate with team members. In the share modal, you can add the user you want to share the view with. You can also set your view access as either public or private. When it's set to public, anyone with the link to the view can edit the view. When it's set to private, others can view but only the owner can edit. + + Views use the same Share modal and access list as designs. After you grant or revoke access, confirm the result under **People with Access**. For guidance on verifying access and for the notifications Kanvas shows when share or visibility actions cannot complete, see [Sharing Designs]({{< ref "kanvas/designer/sharing/index.md" >}}). + To share a view, 1. Click on the actions icon to the right of the view you want to share.