Build artifacts

If your build produces persistent artifacts such as screenshots, coverage reports, or deployment tarballs, we can automatically save and link them for you.

Before each build, we create an empty directory and export its path in the read-only $CIRCLE_ARTIFACTS environment variable.

If you prefer, you can also configure directories and files whose contents will be saved.

After the build finishes, everything in these directories is saved and linked to the build.

You’ll find links to the artifacts at the top of the build page. You can also consume them via our API.

You can also access your artifacts in your browser with the following url:

You can also use latest in place of :build_num together with query parameters branch and filter to access the artifact from the latest build on a branch. filter can have a value of completed, successful, or failed and defaults to completed.

For example:$CIRCLE_ARTIFACTS/hello.txt

That’s all there is to it!

Feel free to contact us if you have any questions or feedback!