Docs Documentación

Objects Gallery

The objects gallery provides a browsable, searchable interface for your collection at /objects/.

Gallery Page

There are two modes, controlled by the browse_and_search setting in your _config.yml:

Browse and Search Mode

When browse_and_search is true (the default), the gallery includes a filter sidebar and a search bar for exploring your collection.

Objects gallery with search bar, sort options, and filter sidebar

Search uses full-text indexing powered by Lunr.js. It searches across title, creator, description, period, subjects, and object type — with title matches weighted most heavily. Type a few characters and results update instantly.

Filters let you narrow the gallery by four facets:

Facet CSV column Example values
Type object_type map, textile, photograph, painting
Creator creator Unknown, Juan de Cuellar
Period period Colonial, 18th century
Subjects subjects weaving, cartography, Lima

Each facet shows the number of matching objects in parentheses. Select multiple values within a facet to broaden results (OR logic), or combine facets to narrow them (AND logic).

Sorting offers two options:

Active filters and search terms appear as removable chips above the grid. Click Clear all to reset.

Simple Grid Mode

When browse_and_search is false, the gallery shows a plain grid of object cards without filtering or search.

For the best gallery experience, fill in these columns in your objects.csv:

  1. object_type for every object — powers the Type filter
  2. subjects with 2–4 comma-separated terms — powers the Subjects filter
  3. year — enables chronological sorting
  4. description — indexed for full-text search
  5. creator and period — power their respective filters

Without these columns, the gallery still works but filtering and sorting options are limited.

You can showcase a selection of objects on your homepage by marking them as featured:

  1. In objects.csv, set featured to yes for the objects you want to highlight
  2. In _config.yml, set show_sample_on_homepage: true under collection_interface
collection_interface:
  show_sample_on_homepage: true
  featured_count: 4

The homepage displays up to featured_count objects (default: 4). If you mark fewer objects as featured than the count allows, the remaining slots are filled randomly from your collection.

The “View the objects” link on the homepage is controlled separately:

collection_interface:
  show_link_on_homepage: true  # Show or hide the link to /objects/

Even when the link is hidden, the gallery page remains accessible through the navigation menu.

Configuration

All gallery settings live under collection_interface in _config.yml:

collection_interface:
  browse_and_search: true       # Filter sidebar and search bar
  show_link_on_homepage: true   # "View the objects" link on homepage
  show_sample_on_homepage: true # Featured objects grid on homepage
  featured_count: 4             # Number of homepage objects

See Configuration Reference for full details on each setting.

See Also