Skip to content
Foundation Docs

Share a lens

Share a lens when you want teammates to see or edit it alongside you. Foundation supports per-user, per-group, and site-wide grants. Only the owner or a user with control permission can change sharing.

Foundation has three permission levels: view, edit, and control. Plus an implicit Owner who always has full control.

Open the share dialog

Section titled “Open the share dialog”
  1. Open the lens.
  2. Click Share in the top-right of the toolbar.

The dialog shows the owner, any existing grants, and a search box for adding people.

Share with a specific user

Section titled “Share with a specific user”
  1. In the share dialog, make sure the toggle is set to Users.
  2. Type a name or email. Foundation searches your Jira site’s users.
  3. Pick the permission level from the dropdown: view, edit, or control.
  4. Click the user in the results. They’re added to the grant list immediately.

Share with a group

Section titled “Share with a group”
  1. Switch the toggle to Groups.
  2. Type a Jira group name (for example, jira-users, platform-team).
  3. Pick a permission level.
  4. Click the group in the results.

Every member of that group inherits the permission you set.

Share with everyone on the site

Section titled “Share with everyone on the site”
  1. In the share dialog, find the Everyone row (or click Share with everyone if no grant exists yet).
  2. Pick a permission level — usually view.
  3. The grant takes effect immediately for every Jira user on the site.

Change or remove access

Section titled “Change or remove access”
  • Change a level. Click the level lozenge next to someone’s name and pick a new one.
  • Revoke. Click the x or Remove button on the grant row.

Changes apply immediately. Revoked users lose access on their next page load.

Transfer ownership

Section titled “Transfer ownership”

Every lens has exactly one owner. If the owner leaves the team or you want a new owner:

  1. Open the share dialog as the current owner (or a site admin).
  2. Scroll to the Transfer ownership section.
  3. Search for the new owner by name.
  4. Click Transfer. The former owner keeps control permission so they don’t lock themselves out.

Jira permissions still apply

Section titled “Jira permissions still apply”

Lens-level access is layered on top of Jira’s own permission model. A user who has edit on your lens still can’t see a row whose issue they don’t have Browse Project permission for in Jira. This is by design — Foundation never exposes Jira data the user couldn’t see natively.

Section titled “Related”