Intro to Archived Items¶
Archived items consist of one or more WACZ files created by a crawl workflow or uploaded to Browsertrix. They can be individually replayed, or combined with other archived items in a collection. The Archived Items page lists all items in the organization.
Uploading Web Archives¶
WACZ files can be given metadata and uploaded to Browsertrix by pressing the Upload WACZ button on the archived items list page. Only one WACZ file can be uploaded at a time.
Status¶
The status of an archived item depends on its type. Uploads will always have the status Uploaded, crawls have four possible states:
| Status | Description |
|---|---|
| Complete | The crawl completed according to the workflow's settings. Workflows with limits set may stop running before they capture every queued page, but the resulting archived item will still be marked as "Complete". |
| Stopped | The crawl workflow was stopped gracefully by a user and data is saved. |
| Stopped: Reason | A workflow limit (listed as the reason) was reached and data is saved. |
| Canceled | The crawl workflow was canceled by a user, no data is saved. |
| Failed | A serious error occurred while crawling, no data is saved. |
Because Canceled and Failed crawls do not contain data, they are omitted from the archived items list page and cannot be added to a collection.
Archived Item Details¶
The archived item details page is composed of the following sections, though some are only available for crawls and not uploads.
Overview¶
View metadata and statistics associated with how the archived item was created.
Metadata can be edited by pressing the pencil icon at the top right of the metadata section to edit the item's description, tags, and collections it is associated with.
Quality Assurance¶
View crawl quality information collected from analysis runs, review crawled pages, and start new analysis runs. QA is only available for crawls and org members with crawler permissions.
The pages list provides a record of all pages within the archived item, as well as any ratings or notes given to the page during review. If analysis has been run, clicking on a page in the pages list will go to that page in the review interface.
Crawl Analysis¶
Running crawl analysis will re-visit all pages within the archived item, comparing the data collected during analysis with the data collected during crawling. Crawl analysis runs with the same workflow limit settings used during crawling.
Crawl analysis can be run multiple times, though results should only differ if the crawler version has been updated between runs. The analysis process is being constantly improved and future analysis runs should produce better results. Analysis run data can be downloaded or deleted from the Analysis Runs tab. While they are stored as WACZ files, analysis run WACZs only contain analysis data and may not open correctly or be useful in other programs that replay archived content.
Once a crawl has been analyzed — either fully, or partially — it can be reviewed by pressing the Review Crawl button. For more on reviewing crawls and how to interpret analysis data, see: Crawl Review.
Paid Feature
Like running a crawl workflow, running crawl analysis also uses execution time. Crawls and crawl analysis share the same concurrent crawling limit, but crawl analysis runs will be paused in favor of new crawls if the concurrent crawling limit is reached.
Replay¶
View a high-fidelity replay of the website at the time it was archived.
For more details on navigating web archives within ReplayWeb.page, see the ReplayWeb.page user documentation.
Exporting Files¶
While crawling, Browsertrix will output one or more WACZ files — the crawler aims to output files in consistently sized chunks, and each crawler will output separate WACZ files.
The WACZ Files tab lists the individually downloadable WACZ files that make up the archived item as well as their file sizes and backup status.
To download an entire archived item as a single WACZ file, click the Download Item button at the top of the WACZ Files tab or the Download Item entry in the crawl's Actions menu.
To combine multiple archived items and download them all as a single WACZ file, add them to a collection and download the collection.
Error Logs¶
View a list of errors that may have been encountered during crawling. Clicking an error in the list will reveal additional information.
All log entries with that were recorded in the creation of the archived item can be downloaded in JSONL format by pressing the Download Logs button.
Crawl Settings¶
View the crawl workflow configuration options that were used to generate the resulting archived item. Many of these settings also apply when running crawl analysis.