Share artifacts
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, Microsoft 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 – Microsoft PowerPoint files.
- Spreadsheets – Microsoft 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 – View the artifact.
- Can edit – View, edit, and share the artifact.
- Can manage – View, edit, share, and remove the artifact.
A recipient can grant or revoke access below their own permission level. A Can edit recipient can grant Can view, and a Can manage recipient can grant up to Can edit. Only the artifact owner can grant Can manage.
Share an artifact
- Go to the Artifacts page.
- Open the share dialog using one of the following methods:
- In list view, click Actions > Share on the artifact row.
- In grid view, hover over the artifact card and click Share.
- In the Share with field, enter the name of a person, team, or role.
- Select who to share with.
- Click the Access drop-down list and select Can view, Can edit, or Can manage.
- Click Send.
- Confirm the Who has access list includes the recipient you just added.
- Click Done.
Update permissions for a shared artifact
- Open the share dialog for the artifact. See steps 1– 2 in the previous section for instructions.
- Locate the user in the Who has access list.
- To change the permission level, click the drop-down list for the recipient and select a different level.
- To revoke access, click Remove for the recipient.
- Click Save.
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
- Artifacts page overview – Browse, filter, and download artifacts.
- Canvas overview – Understand the canvas viewer and supported file types.
Note
If you use Opti ID, administrators can turn off generative AI in the Opti ID Admin Center. See Turn generative AI off across Optimizely applicationsTurn generative AI off across Optimizely applications.