Share artifacts

  • Updated

Share artifacts to give specific people, teams, or your entire instance access to files that Optimizely Opal creates. These include documents, code files, media, presentations, and spreadsheets.

Sharing an artifact also shares every other artifact from the same chat thread or agent execution. To keep permissions separate, create artifacts from different conversations or agent runs.

What you can share

You can share the following types of artifacts:

  • Documents – Markdown, HTML, CSV, PDF, Word files.
  • Code – JavaScript, Python, TypeScript, JSON, Go, Rust, Java, C++, Ruby, Kotlin, Swift, SQL, R, YAML, CSS.
  • Media – PNG, JPG, GIF, SVG, WebP images.
  • Presentations – PowerPoint files.
  • Spreadsheets – Excel files.

Why share artifacts

Use artifact sharing for the following team workflows:

  • Control access – Decide who can view sensitive agent outputs.
  • Enable collaboration – Give teammates access to work products to review or edit.
  • Maintain security – Keep sensitive artifacts private while sharing others with specific people or teams.
  • Track visibility – Identify each artifact's visibility at a glance.

Space-level permissions

Opal uses a space-level permission model for artifact sharing. A space contains every artifact from the same chat thread or agent execution. When you share an artifact, Opal grants the recipient access to the entire space.

Recipients view, edit, or manage every artifact in the space based on their assigned permission level.

Visibility levels

Every artifact displays a visibility indicator on the Artifacts page in the list view:

  • Private – Only you can access the artifact. No one else has access.
  • Shared – Specific people, teams, or roles have access.
  • Instance – Everyone in your Opal instance can access the artifact.

Permission levels

When you grant access, you assign one of three permission levels:

  • Can view – Open and view the artifact.
  • Can edit – Change content and share with others.
  • Can manage – Change content, share access, and remove the artifact.

Only the artifact owner and recipients with Can manage can grant or revoke access.

Share an artifact

  1. Go to the Artifacts page.
  2. Open the share dialog using one of the following methods:

    • In list view, click Actions > Share on the artifact row.

      Screenshot of the Artifacts page with the more menu open and Share highlighted.

    • In grid view, hover over the artifact card and click Share.

  3. In the Share with field, enter the name of a person, team, or role.
  4. Click the Access drop-down list and select Can view, Can edit, or Can manage.
  5. Confirm the Who has access list includes the recipient you just added.
  6. Click Done.Screenshot of the share artifact page with Done highlighted.

Update permissions for a shared artifact

  1. Open the share dialog for the artifact. See step 2 in the previous section for instructions.
  2. Locate the recipient in the Who has access list.
  3. To change the permission level, click the drop-down list for the recipient and select a different level.

  4. To revoke access, click Remove for the recipient.

  5. Click Done.

Constraints

Keep the following in mind when sharing artifacts:

  • Sharing applies at the space level, not to individual artifacts. When you share one artifact, Opal grants access to every artifact in the same space.
  • To keep permissions separate, create artifacts from different chat threads or agent executions.

Related articles