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.
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.
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:
- 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.
- Name – The artifact file name.
- Source – Where the artifact was created. Displays the chat thread name or agent name as a link.
- Created By – The name of the user whose conversation or execution produced the artifact.
- Created – The date and time the artifact was created.
- Size – The file size.
- 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:
- 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.
- Type badge – A label indicating the category: Document, Media, Code, Presentation, or Spreadsheet.
- Name – The artifact file name, truncated if it overflows the card.
- 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.
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.
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:
Grid:
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.
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.
Article is closed for comments.