Artifacts overview

  • Updated

The Artifacts page is a centralized view of all artifacts generated in Optimizely Opal. An artifact is any canvas or file that Opal creates in a chat thread, agent execution, or workflow run. A canvas is an interactive document you view and edit within Opal.

Use the Artifacts page to find past artifacts, filter by type or creator, or download files from agent workflows.

Screenshot of the Artifacts page in list view where canvases and files from conversations, agent executions, and workflow runs display in a sortable table

For information about canvases, how to create them, and how to collaborate with Opal inside a canvas, see Canvas overview and Manage canvases.

Access the Artifacts page

Click Artifacts in the navigation sidebar.

Artifact sources

Each artifact on the page tracks where it was created. The following two source types exist:

  • Chat – The artifact was created during a chat conversation with Opal. The source column displays the chat thread name as a link.
  • Agent – The artifact was created during specialized or workflow agent execution. The source column displays the agent or execution name as a link.
Screenshot of the Artifacts page source column where Chat and Agent labels link to the originating thread or execution for each artifact.

Clicking a source link opens the originating conversation or execution in a new tab.

Switch between list and grid view

Use the view toggle to switch between the following two display modes:

  • List view (default) – Displays artifacts in a table with sortable columns.
  • Grid view – Displays artifacts as visual cards with file previews.

List view

The list view table includes the following columns:

Screenshot of the Artifacts page list view table where the Type, Name, Source, Created By, Created, Size, and More columns display for each artifact row.
  1. Type – An icon representing the artifact category (document, image, code, presentation, or spreadsheet). Hover over the icon to see the specific file type in a tooltip.
  2. Name – The artifact file name.
  3. Source – Where the artifact was created. Displays the chat thread name or agent name as a link.
  4. Created By – The name of the user whose conversation or execution produced the artifact.
  5. Created – The date and time the artifact was created.
  6. Size – The file size.
  7. Actions – Displays available actions. For a description of each action, see Take action on artifacts.

Sort by Type, Name, Created, or Size by clicking the column header. The default sort order is newest first (Created, descending).

Grid view

Each card in the grid view displays the following:

Screenshot of the Artifacts page in grid view where artifacts display as cards with preview thumbnails, type badges, and file names.
  1. Preview – A thumbnail preview of the artifact content. Images show the actual image. Code, HTML, Markdown, and CSV files show a scaled-down preview of the content. Other file types display a category icon.
  2. Type badge – A label indicating the category: Document, Media, Code, Presentation, or Spreadsheet.
  3. Name – The artifact file name, truncated if it overflows the card.
  4. Actions – Displays available actions when you hover over the card. For a description of each action, see Take action on artifacts.

Click any card to open the artifact in the canvas viewer. For information about the canvas viewer interface, see Canvas UI overview.

Search artifacts

Use the Search artifact name field to search by file name. Search results update as you type.

Screenshot of the Artifacts page search field where a user types to filter the results list by artifact file name.

Filter artifacts

The Artifacts page includes three filter drop-down lists alongside the search field. Changing any filter resets you to the first page of results.

Screenshot of the Artifacts page with the filters highlighted.

Type filter

Filter artifacts by category. Click the Type drop-down list and select one of the following:

  • All – Show all artifact types.
  • Document – Markdown, HTML, PDF, and Word files.
  • Media – Image files (PNG, SVG, JPEG, GIF, WebP).
  • Code – Source code and application files across 20+ languages, plus React and Next.js applications.
  • Presentation – PowerPoint files.
  • Spreadsheet – Excel and CSV files.

For a full list of supported MIME types, see Supported formats.

Source filter

Filter artifacts by where they were created. Click the Source drop-down list and select one of the following:

  • All – Show artifacts from all sources.
  • Chat – Show only artifacts created during chat conversations.
  • Agent – Show only artifacts created during specialized agent or workflow executions.

Created by

Filter artifacts by the user who created them. Click the Created By drop-down list and select a specific user, or leave it unset to see artifacts from all users.

Take action on artifacts

Click Actions on any artifact row or grid card to access the following actions.

Row:

Screenshot of the Artifacts page with the Actions highlighted with an arrow.

Grid:

Screenshot of the Actions menu in grid view where Open, Download as, and Go to thread or execution options display for a hovered artifact card

Open

Open an artifact by clicking its row in list view or its card in grid view. The canvas viewer displays the artifact. For information about editing, version history, and collaboration within the canvas viewer, see Collaborate with Opal in canvas.

Download as

Download the artifact to your computer. The available download formats depend on the artifact type. For a full list of download formats by MIME type, see Available download formats.

The Artifacts page supports downloading additional file types beyond those listed in the Available download formats documentation:

  • Image (PNG, JPEG, SVG, GIF, WebP) – Native format (for example, .png, .jpeg)
  • PDF – PDF (.pdf)
  • Word – Word (.docx)
  • Excel – Excel (.xlsx)

For all other file types not covered here or in Available download formats (such as standalone code files), the download defaults to Plain Text (.txt).

Go to thread or execution

Go to the chat thread or agent execution that created the artifact. This link opens in a new tab. The label changes depending on the source.

  • Go to thread – For artifacts created during a chat conversation. Opens the chat thread with the artifact scrolled into view.
  • Go to execution – For artifacts created during a specialized agent or workflow execution. Opens the execution detail page.
This option is not available if the originating thread or agent has been deleted. The source column displays (deleted) in this case.

Pagination

The Artifacts page uses page-based pagination. Use the pagination controls to

  • Go to the next or previous page.
  • Change the number of artifacts displayed per page. The page saves your preferred page size across sessions.

Next steps

  • Canvas overview – Understand supported formats, download options, and the canvas viewer UI.
  • Manage canvases – Create canvases, collaborate with Opal, manage version history, and export content.