---
title: Share artifacts
slug: agent-platform/docs/share-artifacts
docTags: 
createdAt: 2026-08-12T15:37:07.000Z
---

Share artifacts to give specific people, teams, or your entire instance access to files that Mark 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

Agent Platform 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, Agent Platform 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 Agent Platform 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

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.

     ![](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/yUyynA4LWlH1DN5Dm3Qum_image.png)
   - In grid view, hover over the artifact card and click **Share**.

     ![](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/7SQ7vxI1YlF8YFgLjktma_image-1.png)
3. In the **Share with** field, enter the name of a person, team, or role.
4. Select who to share with.
5. Click the **Access** drop-down list and select **Can view**, **Can edit**, or **Can manage**.
6. Click **Send**.

::Image[]{src="https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/GWuIP-Xk4Iggi8uz7-Yxu_image-2.png" size="100" isUploading="false" width="1066" height="448" darkWidth="1066" darkHeight="448" showCaption="false" indent="1"}

7. Confirm the **Who has access** list includes the recipient you just added.
8. Click **Done**.

::Image[]{src="https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/lUr_-orlnY1CzTAo0uRlc_image-3.png" size="100" isUploading="false" width="1054" height="956" darkWidth="1054" darkHeight="956" showCaption="false" indent="1"}

## Update permissions for a shared artifact

1. Open the share dialog for the artifact. See steps 1– 2 in the previous section for instructions.
2. Locate the user 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.

::Image[]{src="https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/KPy9IEXkAFKuX-2whqL99_image-4.png" size="100" isUploading="false" width="1222" height="950" darkWidth="1222" darkHeight="950" showCaption="false" indent="1"}

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

::Image[]{src="https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/EQzy6e4cI_9kySBh8kYNW_image-5.png" size="100" isUploading="false" width="1048" height="304" darkWidth="1048" darkHeight="304" showCaption="false" indent="1"}

5. 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, Agent Platform 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](docId\:Dscxp54gzEtMWur6fT3Ur) – Browse, filter, and download artifacts.
- [Canvas overview](docId:1_VDSKJ_RG0FEQe0MCTv1) – Understand the canvas viewer and supported file types.

:::hint{type="info"}
**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 applications](docId\:X5U0kKD2azV5cIdNqwGNj).
:::