# 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. {% hint style="warning" %} Save the CSV template in UTF-8 format to prevent including non-UTF characters that may break the importer. {% endhint %} ## 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. {% hint style="warning" %} **Title**, **description**, and **severity** are required. {% endhint %}

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.