Importing via CSV Template

PlexTrac provides a downloadable CSV file that can be used as a template for entering writeups offline and importing them into WriteupsDB.

Downloading the CSV Template

Step 1: From the WriteupsDB module, click the Writeups tab.

Step 2: Click Import Writeups.

Step 3: Click Download CSV template file.

The file will be downloaded locally for editing.

Save the CSV template in UTF-8 format to prevent including non-UTF characters that may break the importer.

Writeups CSV Field Mappings

When importing the CSV file, all fields below must appear as column headers and follow the rules defined in the table. Otherwise, the file may be rejected when imported or require further manual editing within PlexTrac.

Title, description, and severity are required.

PlexTrac Field	CSV Header Label	Notes
title	title	This is a required field.
severity	severity	This is a required field. The severity value must be one of the following (not case-sensitive): "Informational, Low, Medium, High, Critical" If no value is provided in CSV, a value of "Informational" will be assigned.
description	description	This is a required field.
recommendations	recommendations	These are the writeup recommendations.
references	references	This field accepts multiple values delimited with a comma. For example: "Item 1, Item 2, Item 3" NOTE: Do not use commas if providing complete sentences, as any comma will result in a para break. Periods do not trigger a para break.
tags	tags	This field accepts multiple values delimited with a comma. For example: "Item 1, Item 2, Item 3"
	custom field	The headers will be converted to keys and labels in the writeup after import. As many custom fields can be used as desired. For example, "custom field 1," "custom field 2," etc.
	score::cvss3	The value before the double colon is the score; the value after is the vector string (calculation), if provided. For example: "9.8::CVSS:3.0/AV:N/AC:L/PR:N/UI:N/S:U/C:H/I:H/A:H"
	score::cvss	For example: "9.5"
	score::YourLabel	Replace "YourLabel" with the Label of a custom scoring system. The value before the double colon is the score; the value after is the vector string (calculation), if provided. For example: "1000::a+b+c+d"
	cves	Separate values with a column. For example: "CVE-1999-0001, CVE-2000-0001"
	cwes	Separate values with a column. For example: "CWE-787, CWE-79, CWE-89"
	score::cvss3.1	The value before the double colon is the score; the value after is the vector string (calculation), if provided. For example: "3.7::AV:A/AC:H/PR:H/UI:R/S:C/C:N/I:L/A:L"
	score::cvss4	The value before the double colon is the score; the value after is the vector string (calculation), if provided. For example: "5.7::AV:L/AC:H/AT:P/PR:L/UI:A/VC:N/VI:L/VA:H/SC:H/SI:L/SA:N"

Importing the CSV Template

Step 1: From the WriteupsDB module, click the Writeups tab.

Step 2: Click Import Writeups.

Step 3: Drag the file into the designated box or navigate to the file on the computer.

Step 4: Click Upload.

When completed, the imported writeups will be displayed within the selected repository.