Skip to main content

Assets

The Asset Library is where a project keeps the files its tests reference — baseline screenshots, fixtures, PDFs, and other inputs. Open it from Settings → Assets, under Project.

Reference an asset from a test​

Reference an asset from a step with asset://<name>, for example asset://login.png. Its handle includes its folder path. Moving an asset to another folder or renaming it changes that handle, so update any tests that refer to the old path.

Organize with folders​

Assets live in a folder tree. Use the breadcrumb to move up and the subfolder list to drill down, and project-wide search to find a file by name across every folder. An asset's full handle is the folder path plus its name (for example asset://baselines/login.png).

Upload files​

Upload images, PDFs, and other fixtures into the current folder. Uploaded files become available to tests by their asset:// handle immediately.

View and preview​

Toggle between list and tile views; tiles show real image thumbnails. Click an image to open it full screen in a lightbox.

Manage in bulk​

Select multiple assets to delete or move them between folders in one action. Deleting an asset breaks any test that references its handle until you re-upload it.

Imported screenshots​

When you import a feature from a PDF, the page screenshots captured during the import are promoted into the library automatically, filed under an Imports/<name> folder so they stay grouped and out of the asset root.