Bases HelperField notes for your Bases workspace

CARDS & ATTACHMENTS

Obsidian Bases Cards: Add Cover Images and Fix Blank Cards

Add a quoted attachment link such as cover: "[[Assets/atlas.svg]]" to a note, then select cover as the Cards view's Image property. Merely placing an image in the note body does not configure this explicit-cover workflow.

Published November 1, 2026 · Built-in Bases · Native checks: Obsidian 1.14.5 / macOS

Start with two working covers and one deliberate blank

A card gallery is useful when the image helps you recognize a note: book covers, project sketches, or reference sheets. This example keeps that connection explicit with one cover property per note.

Download the workspace practice vault (.zip)

Open the unzipped folder as a separate vault and open Cards.base. Atlas field notes and Beacon field notes have local cover images. No cover yet deliberately has no cover value and remains in the collection with an empty image area.

Three cards: Atlas and Beacon with local covers and one deliberately empty cover.
Native Cards view with original sample artwork, captured November 1, 2026 in Obsidian 1.14.5 on macOS. No community plugins or remote images.

The colored covers are original geometric SVG test assets included in the download. They are not third-party book artwork, and the example does not request external images.

1. Store a link to an existing image

Keep an image in the vault's Assets folder. Create a note under Cards and use the following in Source mode:

Note · Source mode
---
cover: "[[Assets/atlas.svg]]"
status: reading
---

# Atlas field notes

The outer quotes preserve the internal link as a YAML value. In the normal Properties editor, you can enter or select the internal link without writing the entire YAML block. Use Obsidian's link suggestions to pick the actual attachment, especially when files share names.

For a normal photo, the equivalent would be cover: "[[Assets/my-photo.jpg]]", provided that file exists. The example uses one attachment link, not a list of images. It also uses [[...]] in the property, rather than a body-style ![[...]] embed.

2. Tell the Cards view which property supplies the image

  1. Open your base and use the view menu to choose or create a Cards layout.
  2. In that view's settings, select cover for Image property.
  3. Choose Contain if you want to see the full cover, including its edges.
  4. Use card size and image aspect ratio to adjust the available space. These are layout choices, not fixes for a broken attachment link.

Cover fills the image area and may crop an edge. Contain preserves the whole image and can leave unused space. If a title or a diagram border is missing, check this setting before changing the source image.

For the downloadable collection, this complete configuration selects the cover field and uses Contain:

Complete .base file
filters: 'file.inFolder("Cards") && file.ext == "md"'
views:
  - type: cards
    name: Covers
    order:
      - file.name
      - note.status
    image: note.cover
    imageFit: contain
  - type: table
    name: Check properties
    order:
      - file.name
      - note.cover
      - note.status

Save it as Cards.base, not inside a note's property block or the Formula field. The folder and extension filter keeps the rows limited to Markdown notes in Cards. It excludes the SVG files from becoming extra cards.

Diagnose a blank card in a fixed order

What you seeCheck next
No card for the noteCheck folder, file type, and status filters. This is a row-selection problem.
Card title appears; image is emptyCheck that cover exists on that specific note and points to an existing attachment.
Link opens the image; card still emptyCheck the active Cards view's Image property. Showing cover as ordinary metadata is a separate setting.
Image appears but an edge is cut offSwitch Image fit from Cover to Contain.
Works in the sample but not after copyingCopy Assets too, then check folder filters, renamed files, and link targets.

The sample's Check properties table is a useful comparison view: it shows the exact cover value alongside each title. No cover yet provides a known blank case, so you can distinguish missing data from a layout failure.

Official documentation also allows external image URLs and color values. Those are separate inputs: a remote image can depend on network access or permissions. This guide verifies local attachments only. It does not promise video thumbnails, PDF page covers, or automatic first-image extraction.

Use the cover field in your own collection

Start with one note and one image before importing a whole library. Confirm that the attachment opens and the Cards view displays it. Then extend to other notes, using the same field name and a consistent attachment location.

If you already use the reading tracker, add a cover property to a book note and create a Cards view in the same base. Keep the page-count fields for the existing progress workflow. A cover image adds a visual entry point; it does not change how progress is calculated.

For notes without artwork, you can keep the deliberate blank or use the standard table view. Do not delete useful notes just to make every card look identical. See the filter guide if the problem is which notes enter the collection.

Testing and references

On November 1, 2026, we opened the sample in Obsidian 1.14.5 on macOS. Cards displayed three notes: two local SVG covers with their full borders visible under Contain, and one note with no cover. The matching table exposed the attachment properties. Other versions, mobile, remote URLs, and automatic cover formulas were not tested.

References: Cards view and image settings and note properties. Read our testing method.