Overview
Pwnbook’s report generation takes the data you’ve captured during an engagement — findings, targets, tasks, and threat models — and turns it into polished, professional deliverables. Reports are generated from templates, so your output is consistent across engagements and easy to customize for different clients or report types.
Creating a report
- Open an engagement and navigate to the Reports tab.
- Click New Report.
- Select a report template from your available templates (see Report Templates below).
- Enter a report title and any metadata the template requires (e.g., assessment period, client name, executive summary text).
- Click Create.
The report is generated and opens in the report editor, where you can review, edit, and finalize the content.
Report editor
The report editor gives you a structured view of the generated report. You can:
- Edit any section directly
- Add, remove, or reorder sections
- Insert findings from the engagement’s wiki or task list
- Adjust formatting and styling within the template’s constraints
- Preview the report as it will appear to the reader
Write your executive summary last, after reviewing all findings. The report editor autosaves changes so you can work on the report across multiple sessions.
Report templates
Report templates define the structure, sections, and styling of generated reports. Pwnbook ships with built-in templates for common report types:
| Template | Description |
|---|
| Penetration Test Report | Full technical report with executive summary, methodology, findings, and remediation guidance |
| Executive Summary | A shorter, non-technical overview for leadership and board-level stakeholders |
| Vulnerability Report | A focused listing of vulnerabilities with severity, CVSS scores, and reproduction steps |
| Compliance Assessment | Structured around a compliance framework (e.g., PCI-DSS, NIST, ISO 27001) |
Custom report templates
Custom report templates are available on the Business and Enterprise plans.
- Go to Organization Settings → Report Templates.
- Click New Template.
- Use the template editor to define sections, placeholders, and styling.
- Publish the template to make it available for all engagements in your organization.
Templates support dynamic placeholders that are populated from engagement data (e.g., {{engagement.name}}, {{findings.critical.count}}).
Exporting reports
Once your report is finalized, export it for delivery:
- Open the report.
- Click Export in the top right.
- Choose the output format:
- PDF — Suitable for client delivery and archival
- DOCX — Editable Word document for clients who need to make modifications
- HTML — Web-based version that can be hosted or included in an email
Dashboards
Dashboards give you and your team a visual summary of engagement metrics. Unlike reports, dashboards are designed for internal use and update in real time as the engagement progresses.
Creating a dashboard
- Navigate to the Reports tab and click Dashboards.
- Click New Dashboard.
- Enter a dashboard name.
- Click Create.
Adding tiles
Dashboards are composed of tiles — individual widgets that display specific metrics or summaries. To add a tile:
- Click Add Tile on the dashboard.
- Choose a tile type from the library:
| Tile Type | Description |
|---|
| Finding Count | Total number of findings by severity |
| Task Progress | Open vs. closed tasks, optionally filtered by assignee |
| Target Status | Recon scan status for all targets |
| Severity Breakdown | Pie or bar chart of findings by severity |
| Engagement Timeline | Key milestones and activity over time |
| Custom Metric | A number or chart you define from engagement data |
- Configure the tile (data source, display options).
- Click Save.
Tiles can be resized and rearranged by dragging on the dashboard canvas.
Dashboard templates
If you want the same dashboard layout across multiple engagements, save it as a dashboard template:
- On a configured dashboard, click Save as Template.
- Give the template a name.
- Click Save.
Next time you create a dashboard in any engagement, you can select this template to start with your preferred layout pre-configured.
