← Help Center

Context

How to Format a CSV Dataset for Use in Vloggi

Illustration supporting How to Format a CSV Dataset for Use in Vloggi

Prepare a CSV table with a header row, one record per row and a clear key column. A dataset can represent stores, departments, categories or contributors—not only a list of people.

Recommended structure

  • Save as a comma-separated .csv file.
  • Use short, descriptive column headers.
  • Keep one record per row and one value per cell.
  • Choose a key column with a unique, nonblank value for each record.
  • Include only columns useful for the intended lookup, tagging or display.

Keeping the table to around six useful columns makes it easier to manage; this is a recommendation, not a universal six-column limit.

Example store dataset

StoreIDStoreRegion
S001CentralNorth
S002RiversideSouth

In this example, StoreID is the unique key. Store and Region are related values belonging to the same row.

Clean up before uploading

Remove blank rows, duplicate keys, repeated header rows and irrelevant notes. Preserve identifiers such as 00125 as text so a spreadsheet does not remove leading zeroes. Check accented characters and punctuation in the exported CSV.

Create and review the dataset

Open Datasets → Create a New Dataset in Studio. Upload the CSV, review the preview, confirm the headers and select the intended key column using the controls shown. Resolve any validation messages before saving.

Use it in a project

Under Collect → Contributor Data, add a structured question and link the dataset. Choose the appropriate column and review how contributors select or enter a value. Add tagging or dynamic video fields only where needed.

Keep the dataset appropriate for its audience

Use non-sensitive reference data where possible. A searchable field is not authentication and should not be treated as a guarantee that other records cannot be discovered.

Continue with linking a dataset to a contributor question.