A collection is a library of prompts used as input for Cannon test runs. Create one, add the prompts you want to test, then send it through a profile with Cannon.

1. Navigate to Collections.

2. Click Create Collection.

3. Enter a name for the collection. A name is required. You can also enter an optional description.

4. Click Create. The collection's detail page opens with an empty prompt list and a CSV drop zone.

Once the collection exists, add prompts to it one of two ways.

• To add prompts from a file, drag a CSV onto the drop zone or click Browse your PC to select one. Each upload is recorded in the Upload History section.
• To add prompts one at a time, type a prompt into the prompt input bar at the bottom of the page and submit it.

CSV Format Requirements

A CSV uploaded to a collection must be a single column with no column header, with every prompt in column A. The file must be encoded as UTF-8. Only UTF-8 is supported, and a file saved in any other encoding will fail to upload.

Keep the following in mind when preparing a file:

• Any columns other than column A are ignored.
• A single empty row is ignored, but two or more consecutive empty rows stop the rest of the file from uploading.
• Large files may take some time to import.
• Files with more than 25,000 rows may time out. If an upload does not succeed, split the file into smaller parts and try again.

Saving a CSV as UTF-8 from Excel

To save a file with the correct encoding from Excel:

1. Open the file in Excel.

2. Choose Save As.

3. Select UTF-8 as the encoding.