V3.07.5Notifying affected collaborators of permission changesdesign

Permission changes must notify affected collaborators

Aliases: permission change notification · removal notice · downgrade notice · permission event alerting

What it is

Sharing permissions are not a configure-once static setting but a continuing event stream: someone gets added, someone gets removed, a person's tier climbs from view to edit, a link gets shut off. Keeping the current state visible next to the content answers "what is the scope right now"; this card covers the other half — the change itself must reach the people it affects, as an event. The affected come in two directions: gainers (granted or promoted, who need to know what they can now do — otherwise the permission sits unused) and losers (downgraded or removed, who need to know from what moment access ends, and whom to approach for recovery from a mistake). The notification's recipient is the affected collaborator, not merely the operator — precisely the party who did nothing needs it most.

Why it happens

Permission changes are structurally invisible in the collaboration surface: they happen deep in a settings panel, the content does not move a pixel, and the affected party has no natural channel to notice. Yet collaborative behavior runs on a permission snapshot — "I can comment on this document," "these five people see my updates" — and without notification the snapshot never refreshes, so everyone keeps acting on stale permissions: planning around someone already removed from the share, scheduling work on a document they can no longer modify. The two directions carry asymmetric needs: downgrades and removals must be notified above all, because the losing party needs a definite moment of expiry to adjust expectations and a recovery path (whom to contact, on what basis) to absorb mistakes and misjudgments; upgrade notifications earn their keep by making new capability discoverable. The notice must also be actionable: "permissions changed" alone says nothing — spell out which object, from what tier to what tier, effective when, and what to do next: open the object, inspect the source, contact the owner.

Where it stops holding

Not every change deserves an interruption. Large-scale adjustments (organization migrations, group reorganizations) would unleash a notification storm that buries the critical signals, so tier and aggregate: critical changes — access lost, external visibility enabled — go out individually and immediately; bulk and minor changes collect into a digest grouped by object. Notification solves "knowing," not "preventing" — vetting and confirmation before the change is a separate matter, and the two defenses pair up: confirmation intercepts the operator's own mistakes, notification catches the leaks and everyone else's operations. One more restraint: the notice carries only the facts of the recipient's own access, never the operator's motives or commentary, lest permission management turn into a public pillory of persons.

Applying it

  • Event-sourcing permission changes: every change emits a structured event (which object, whose permission, from what tier to what tier, effective when, by whose operation), serving notification and audit from one data source.
  • Deliver in both directions: upgrade notices go to gainers with the new capability and its entry point; downgrade and removal notices go to losers with the expiry moment and the recovery path spelled out.
  • Tier and aggregate: single-object critical changes notify immediately; bulk adjustments collapse into a digest grouped by object, averting the storm.
  • Embed next actions in the notice: open the object, view the permission's source, contact the owner or request restoration — turning "aware" into "able to respond."
  • Verification: track collaboration incidents and support tickets caused by acting on stale permissions; spot-check whether removed collaborators know their expiry moment and recovery route — murkiness in either means the notification design failed.

Related

  • Same group: V3.07.1 Sharing scope must be persistently visible next to the content · V3.07.2 The semantic difference between view, comment, and edit permissions · V3.07.3 Expanding the sharing scope requires explicit confirmation · V3.07.4 The understandability of permission inheritance and exceptions
  • Nearby: V2.03 Change Awareness · V7.04 Content Governance
  • Search terms: permission change notification · access revocation notice · share event · notification aggregation

Cards in the same group

Quick Actions

Share

Share this page

ios_share

https://hci.top/en/handbook/V3.07.5