Add an artifact
Atlassian Artifacts is in beta. It’s available to all paid plans. The experience may change while we improve features and add new ones.
An artifact might be a chart, an image, a report, or a diagram, or anything else you need. Because it is a standalone file, you can revisit, reuse, and share it with others at any time.
Rovo will always save a new artifact as private. Always check the privacy settings of an artifact created by other AI agents. You can change the privacy of an artifact at any time. See Share an artifact
Before you can do that, you'll need some artifacts. You can create artifacts with Rovo or any other connected AI agent, or you can upload your own.
Create an artifact with Rovo
Any file that Rovo creates for you is an artifact. Rovo automatically adds every artifact to your Artifacts library.
Other interactions with Rovo, such as smart links to Rovo-created Confluence pages or files you’ve uploaded in a chat, aren’t artifacts and aren’t stored in your Artifacts library. You can find those interactions in your Rovo library.
To create an artifact with Rovo:
Go to Rovo Chat using your preferred method.
Ask Rovo to create something for you.
For example, Create an interactive HTML dashboard showing my team’s progress on Jira work items and celebrate anything that was completed.
That’s all you need to do. Rovo has already added the artifact to your Artifacts library. If you want to see for yourself, select the link that Rovo has included for you, or ask it to take you to your Artifacts library.
Create an artifact with a third-party agent
You can ask a third-party AI agent to create an artifact for you. These agents are outside of your Atlassian environment, so be aware of these two extra requirements before you get started.
The third-party agent must already be connected and authenticated to the Atlassian MCP server or Teamwork Graph CLI (see Get started with the Atlassian MCP server and What is Teamwork Graph CLI?).
For reliable results, tell your third-party agent to save a file to Atlassian Artifacts each time you want it to save something (it probably will anyway).
Third-party AI agents are outside your Atlassian environment, so they may act differently when you ask them to make a change to an artifact. Always check the results in Atlassian Artifacts while you’re prompting.
You can check you’re connected by asking your agent something like “Check my Atlassian MCP v2 connection using MCP v2”.
To create an artifact with a third-party agent:
Open your preferred AI agent.
Ask the agent to create something for you.
For example, Create an interactive HTML dashboard showing my team’s progress on Jira work items and celebrate anything that was completed. Save it to Atlassian Artifacts.In your Atlassian environment, select the app switcher () in the top navigation bar, then select Artifacts from the list.
Check that you can see your new artifact listed, and select it if you’d like to view it.
If you want a third-party AI agent to always upload files it creates to Atlassian Artifacts, you can try telling it do that automatically from now on.
Limitations to artifact creation
Creating an artifact enables you to make all sorts of useful outputs for you and your team. When an agent builds an artifact using code, such as JavaScript, or a markup language such as HTML, it might build more than a single file. Whether you’re using Rovo or a third-party AI agent, be aware of the following:
Limitation | Workaround |
|---|---|
An artifact is a single file, so all its functionality must exist within it. | Tell your agent to include everything within one file. |
An agent might try to use local storage for interactive files. | Tell your agent to avoid local storage |
An agent might try to use various JavaScript features that are disabled for security or other reasons. | First, test your artifact from the Atlassian Artifacts app area. Then, if something doesn’t work, tell your agent to check that the code can run from Atlassian Artifacts. |
Upload an artifact
You’re not limited to using AI agents to add artifacts to your library. You can upload your own whenever you like. Maybe you like having a central home for files you want to embed in multiple places or share with teammates. You might also need to manually upload an artifact that a third-party AI agent failed to save to your Artifacts library.
To upload an artifact:
In your Atlassian environment, select the app switcher () in the top navigation bar, then select Artifacts from the list.
Select Upload to open the Upload file(s) to Artifacts dialog box.
Select Upload file, then locate and select the file you wish to upload. Artifacts will upload the file and display it on the screen.
Use the options on the pull-out Rovo bar at the bottom of your screen if you wish to do more with the file, such as sharing it.
Was this helpful?