Gallery View

Overview

The gallery view displays records as cards laid out in a grid. Each card can show a cover image from an attachment field, the record's primary field as a title, and a few additional summary fields. Clicking a card opens the record detail page.

Use gallery when the visual matters more than the structured data: a property portal, a member directory, a product catalogue, a portfolio.

Configuring a Gallery View

1. 1

   Open the Display tab

   In the portal admin, open the role, expand the table, and switch to the Display tab.

2. 2

   Pick Gallery as the view type

   Set the View type dropdown to Gallery. New configuration fields appear below.

3. 3

   Pick a cover field (optional)

   The Cover image dropdown lists every attachment field on the table. Pick one and CollabPortals shows its first attachment as the card cover.

   Leave it set to None if you don't want a cover image. Cards still render, just without the image area.

4. 4

   Pick the card fields

   Check the fields you want shown on the card under the primary field. See Summary Fields and Record Detail for the full reference.

Cover Image Behaviour

• The cover dropdown only lists fields of type Attachment.
• If the table has no attachment field, the dropdown still lets you pick None but the message underneath explains that you need to add an attachment field in Airtable to use a cover.
• If a record's attachment field is empty, the card renders without an image.
• The first attachment is used. To control which image shows, reorder attachments in Airtable.

Card Layout

Every card includes:

1. Cover image (if a cover field is set and the record has an attachment)
2. Title (the record's primary field)
3. Card fields (the additional summary fields you picked)

Hidden fields and fields not in the card selection don't appear on the card, but they still show on the detail page when the user clicks through.

Permissions

Gallery view respects all the usual permissions:

• A field that is Hidden in field permissions never appears on the card or the detail page.
• Edit and delete buttons appear on the detail page based on table permissions.
• The user-based record filtering still applies: each user sees only records linked to them.

Tips

• Pick a meaningful cover. A photo, logo, or thumbnail makes the gallery scannable.
• Two or three card fields is plenty. Status, location, owner. The rest belong on the detail page.
• Combine with default sort. A gallery sorted by date or status gives a sense of structure without losing the visual layout.

Next Steps

• View Types - Compare the four layouts
• Summary Fields and Record Detail - Pick which fields show on the card
• Supported Field Types - How attachments render
• Field Permissions - Hide a field entirely