Importing via CSV Template

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

Downloading 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

All fields below must appear as column headers when importing the CSV file and follow the rules defined in the table, or 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.
	score::cvss3	The value before the double colon is the score; the value after is the vector string (calculation), if provided.
	score::cvss	The value before the double colon is the score; the value after is the vector string (calculation), if provided.
	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.

Importing 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.