Contribute

Add data to the venue index

How to Contribute

Download the template file below.
Choose either the TSV or Excel format to get started.
Fill in the required information for each venue.
Refer to the field descriptions in the table below for guidance.
Save your completed file.
Use a clear filename, such as your-dataset-name.tsv (tab-separated values) or your-dataset-name.xlsx (Excel spreadsheet).
Submit your file using one of the following methods:
- Open an Issue: Attach your TSV or Excel file and provide the required dataset metadata (see below).
- Create a Pull Request: Fork the repository, add your TSV and a generated JSON-LD file, and submit a pull request.
  To generate the JSON-LD file, run: node scripts/tsv_to_jsonld.ts
  Before running the script, update static/index.json with your dataset metadata.

Choose Your Submission Method

Submit via Issue

Open an issue and attach your TSV or Excel file, along with metadata about your dataset.

Open Issue

Submit via Pull Request

Fork the repository, add your TSV and a generated JSON-LD file, and submit a pull request.

Visit Repository

Data Template

Download template (TSV) Download template (Excel) Download example (TSV)

Field	Description	Example	Status
`id`	Unique identifier for the venue	http://www.cinemacontext.nl/id/B000016	Optional
`name`	Name of the venue	Kriterion	Required
`description`	Detailed description	Filmtheater Kriterion, officieel...	Optional
`additionalTypeId`	ID for venue type, split multiple values by semicolon (;)	cinema	Optional
`additionalTypeName`	Type of venue, split multiple values by semicolon (;)	Art house cinema	Optional
`startDate`	Date when venue opened (YYYY-MM-DD)	1945-11-06	Required
`endDate`	Date when venue closed (YYYY-MM-DD)	(Empty when still in operation)	Optional
`addressLocality`	City	Amsterdam	Optional
`addressRegion`	Province/state code	NH	Optional
`postalCode`	Postal code	1012	Optional
`streetAddress`	Street address	Roetersstraat 170	Optional
`latitude`	Geographic latitude	52.3625	Required
`longitude`	Geographic longitude	4.910556	Required
`citation`	Bibliographic reference, split multiple values by semicolon (;)	Cinema Context	Optional
`sameAs`	External identifier URL, split multiple values by semicolon (;)	http://www.cinemacontext.nl/id/B000016	Optional

Note

For fields that allow multiple values (additionalTypeId, additionalTypeName, citation, sameAs), separate each value with a semicolon (;) character.

If the additionalTypeId and additionalTypeName fields are left empty, the type will be Venue by default.

Dataset Metadata

Field	Description	Example	Status
`name`	Title of your dataset	Cinema Context	Required
`description`	Brief description of the dataset content and scope	Cinema Context is a database of Dutch cinema and film culture.	Required
`citation`	How to cite your dataset (include URL if applicable)	Cinema Context. n.d. Cinema Context. https://www.cinemacontext.nl/	Required
`url`	URL to the original source or project website	https://www.cinemacontext.nl/	Optional
`dateModified`	Date when the dataset was last updated (YYYY-MM-DD)	2025-03-20	Optional