> ## Documentation Index
> Fetch the complete documentation index at: https://help.teable.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Gallery

> Display records as image cards for product catalogs, asset libraries, and portfolios.

Gallery view displays records as image cards. Use it when images are the main content of the table, such as product photos, design drafts, campaign assets, photo libraries, or portfolios.

## Use Cases

| Scenario         | Good for                                         |
| ---------------- | ------------------------------------------------ |
| Product catalogs | Product images, models, prices, status           |
| Asset management | Design drafts, campaign assets, ads, screenshots |
| Portfolios       | Project covers, case images, design work         |
| Image review     | Filter image records by status, owner, or tags   |

## Create a Gallery View

<Steps>
  <Step title="Create a view">
    Click `+` next to the view tabs.
  </Step>

  <Step title="Choose Gallery view">
    Select **Gallery view** from the view types.
  </Step>

  <Step title="Configure cards">
    After the view opens, use **Customize cards**, filters, and sorting to adjust how records appear.
  </Step>
</Steps>

## Set the Cover Image

Gallery view can use an attachment field as the card cover. If the table already has an attachment field, Teable selects one by default.

| Setting        | Description                                                                                                                                           |
| -------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- |
| Cover field    | Choose an attachment field to use as the card cover, or choose **No image**                                                                           |
| Multiple files | If the selected attachment field has multiple files, the first file is shown first on the card; users can switch between files from the card carousel |
| Fit            | When enabled, the whole image fits inside the cover area; when disabled, the image fills the cover area and may be cropped                            |

## Configure Card Information

Click **Customize cards** in the toolbar to choose which fields appear on cards, reorder fields, and turn **Hide field name** on or off.

Keep only fields that help identify the record, such as name, status, owner, price, or tags. Too many fields make Gallery view harder to scan.

## View and Edit Images

* Click a cover image to open the preview.
* In preview mode, switch between files, zoom or rotate images, or download the file.
* Click the card body to open the record.

## Manage Records

* Click **Add record** in the toolbar to add a record. If an attachment field is available, you can upload files from the record editor.
* Right-click a card to delete the record or use other record actions.
* Use filters and sorting to manage image records by status, category, or owner.

## Notes

* Gallery view works best when attachment images are central to the table. If records are mostly text or numbers, Grid view is usually faster.
* Field display settings in Gallery view only affect the current view. They do not delete field content.
* Create, edit, delete, and file actions depend on your view, record, and field permissions.