Link Search Menu Expand Document


The data section helps connect your metadata to the variety of data derivatives that CollectionBuilder can create. This is a powerful feature that generates machine-readable metadata derivatives that users can download from your collection site, or that you can use yourself to identify patterns in your collection data. For instance, we often use the “facets.json” file to determine which fields should be visualized in our collections’ word clouds.


  • A list of metadata fields available for export via data downloads.
    • If you’d like all your fields included, paste in the first row of your collection’s CSV
    • This variable determines what metadata will be made available for download via the ‘Download Data’ options on the Home page and on the Data page.
    • Format: Comma-delimited list contained between quotes
      metadata-export-fields: "title,description,subject,date,date is approximate,source,latitude,longitude,subject (lcsh),format-original,donor,identifier,format,language,type,rights,rightsstatement"

Pro Tip: For the metadata-export-fields section, copy and paste the first row of your collection metadata CSV (i.e. your metadata fields) into this variable.


  • Generates a facets list download option for given fields.
    • Format: Comma-delimited list contained between quotes
      metadata-facets-fields: "subject,locations,format"

Pro Tip: We use the “facets.json” file quite extensively when designing our sites. By adding a variety of fields here, you can generate a quick overview of the metatdata terms and their counts that are used for a certain category. This often leads to our adding more fields to our “subject-fields” option described in the Subjects Page section.