Skip to content
notionsolutions

A practical library for building,
organizing and working in Notion.

Workflow guides

Notion Gallery View: Card Images, Sizes and Settings

A Notion gallery view shows each database page as a card, and Card preview decides which image sits on top. Here's how to add the view, where each image source lives, what size to upload, and the exact settings for a mood board, a team directory and an asset library.

Published
Six white ceramic cards in a grid, five with blue glass in their picture windows and one with an empty window, next to the headline Notion Gallery View
Each card shows the image its view is told to look for, and a card without one stands out in the grid.

A Notion gallery view shows each database page as a card, and one view setting decides which image sits on top: Card preview. Add the view with + next to the view name → Gallery, or type /Gallery view on any page. Then open the view settings → Layout → Card preview and pick Page cover, Page content or a Files & media property. I'd choose that image source before adding a single picture, because a blank or wrong card usually means the image lives where the preview isn't looking.

For a mood board or portfolio, choose Page cover with large cards. For a team directory or a client asset library, choose a Files & media property such as Photo, which you can fill straight from a table. For recipes, screenshots or notes where every page already opens with its main image, Page content is enough. The exact settings for all three are in the setups section further down.

Pick the route by where your records live now. Notion's gallery help lists three:

I'd use the third route whenever the records already exist. The gallery becomes one more view of the same pages, and Notion's view settings note says each database view has its own settings, so the card setup you build here won't change the table, board or calendar you already rely on.

If the database sits on another page, Notion lets you link a view of it where you want the gallery; switch that linked view to Gallery. The cards are the source database's own pages, which matters the first time someone edits one; what an edit in a linked database changes in the original covers that question.

Which image does a gallery card show?

The one Card preview points at, and you set it per view: open the view settings (••• at the top right of the database) → Layout → Card preview. Each option reads from a different place in the page. A card goes blank, or shows the wrong thing, when the image sits somewhere else.

Card preview options in a Notion gallery
Card previewWhat the card showsWhere the image goesWhen it breaks
Page coverThe image chosen as that page's coverAdd cover at the top of each page, then Change cover → Upload, Link or UnsplashA page has no cover, or its picture was placed in the page body
Page contentA preview of the page's first block; an image or video there shows as the pictureAn image block as the very first block of the pageSomeone adds a line of text above the image, and the card previews that text
Files & media property, such as PhotoThe image files uploaded to that propertyThe property field: upload, paste a link, or drag a file inThe property is empty on that page

The Files & media option appears in the Card preview menu under the property's own name once the database has one. Covers come from Add cover: hover over the cover, choose Change cover, then upload your own image, paste an image URL with Link, or search Unsplash. A Files & media field, per Notion's property help, takes an upload, a pasted link to embed a file, or a file dragged in from your computer. Notion's image help adds the quickest route: “Drag an image file into a card on a database board, or into a Files & media property cell in a table, or into a gallery.”

A record doesn't need an image to appear. Notion's view help says you can point a gallery at images in a Files & media property, and “otherwise, the gallery will show any content that the database page contains,” so a page with no picture still gets a card, just a text one. Several gallery guides, Notionland's and Super's among them, also describe a None option that hides images and leaves only the properties; if every card in a view turns text-only at once, check Card preview before anything else.

My default is a Files & media property named Photo for anything that works as a directory or a library. The image stays apart from the page's writing, so nobody breaks a card by adding a note at the top, and you can fill the whole column from a table view in one sitting. Page cover is the right call for mood boards and portfolios, where the cover is the content. Page content I'd keep for databases where every page already opens with its picture, such as recipes or screenshots, and only while everyone adding pages knows the image has to stay first.

Notion only reads the spot you point it at. Deciding where images live, and telling everyone who adds records, stays with you; a short note beside the database saves a round of blank cards later.

A database page with Cover, Photo and First block zones, each linked by an arrow to a gallery card for Page cover, Files & media: Photo and Page content, plus a card showing only text lines
Each Card preview option reads one spot on the page, so the image has to sit where the view is looking.

What image size works on gallery cards?

Upload images at least 1,500 px wide, keep one aspect ratio across the database, and keep the subject near the middle of the frame. That's where the published advice lands once you line it up, even though the guides disagree on shape.

Published image-size advice for Notion galleries and covers
SourceSizeAspect ratioWhat it covers
Notion helpAt least 1,500 px wideNone givenPage covers
Super1500 × 600 px5:2Gallery cover image
Notionland1500 × 600 px5:2Cover image in a gallery
Pictey800 × 600 px minimum4:3 preferredDatabase gallery
ones.com1000–1500 px wide16:9 or 4:3Gallery view images

Across the four independent guides, the ratio advice splits three ways. Super's gallery guide calls 1500 × 600 px ideal and says any 5:2 image should work, and Notionland's gallery guide gives the same 1500 × 600 px at 5:2. Pictey's Notion image guide sets an 800 × 600 px minimum for a database gallery with 4:3 preferred, while ones.com's image-size article suggests 16:9 or 4:3 at 1000 to 1500 px wide, citing “extensive testing and user feedback” without showing the method. That's 5:2 twice, 4:3 twice and 16:9 once.

Widths agree far more than ratios. They run from 800 to 1,500 px, and the median of each source's headline width is 1,500 px across all five, whichever end of the ones.com band you count. Notion's cover-image advice is the floor I'd build on: covers are “dynamic depending on the width of your window, so there's no specific size that works best,” and Notion recommends “images at least 1,500 pixels wide.”

The two 5:2 picks describe banner proportions; Pictey's own size table lists a page cover at 1500 × 600 px, 2.5:1. That suits a Page cover gallery, where the same image also heads each page. For a directory or a library, the exact ratio matters less than keeping it identical across records.

Notion publishes no pixel size for small, medium or large cards, and its cover advice ties the visible area to window width, so build for the crop rather than for one perfect size:

That 5 MB rule comes from Notion's file limits. On the Free Plan, “all files you upload must be under 5MB.” On paid plans the same page's FAQ allows uploads of up to 5 GB per file, but its note still keeps PNG and JPG images under 5 MB. If Notion reports that an image is too large to be displayed, its help suggests uploading the image as a file instead; for a card picture, I'd upload a smaller copy. Format rarely needs converting: the supported list includes HEIC, ICO, JPEG, JPG, PNG, TIF, TIFF, GIF, SVG and WEBP.

Set card size, Fit image and Reposition

Card size and Fit image both sit under Layout in the view settings, and Reposition works on each card by hover. Between them they decide whether a gallery reads as a tidy grid or a patchwork.

Card size

Notion's gallery guide names the three choices: small, medium or large. Large lets the image carry the record on its own; small fits more cards in a row when people scan by name and tag. I'd start at medium and change it only after the images and properties are in, because the right size depends on how much text sits under each picture.

Fit image and Reposition

Notion's gallery help describes both states. With Fit image off, “the image will be cropped to fill the entire card frame,” which gives an even grid when every image shares one shape. With it on, “the entirety of the image will fit within the frame of the card,” so tall posters, logos and screenshots show whole, with empty space around them. The same help adds that you can hover over an image on a card and select Reposition to drag it into the position you want, and Super's guide uses that option to move a cropped cover around inside the card's frame.

My split: off for photos of people, places and products shot the same way, on for anything where a cropped edge loses information, such as a screenshot, a chart or a logo.

The same tall poster in two landscape cards, cropped to fill the frame with Fit image off and shown whole with side space with Fit image on, above small, medium and large card outlines
Fit image off fills the frame and crops the edges; on shows the whole picture with space around it.

Hide Name and wrap properties

For a mood board or a photo wall, switch off Name in the view's Properties menu so the image stands alone. Notion's help calls that “Helpful for simple and elegant mood boards and photo collections.” When long values get cut off under the image, use the gallery option Notion announced to wrap all properties so info is fully visible. Organized Notebook's gallery tips put that toggle in the view's Properties menu; turn on Wrap all properties when emails, roles or titles end in an ellipsis.

Choose which properties show on cards

Open the view settings → Property visibility, click the eye icon next to a property to show or hide it, and drag ⋮⋮ to set the order it takes on the card. I'd show two to four properties, the ones that let someone recognize a record without opening it: role and team in a directory, type and date in a library, status where work moves through stages. Everything else stays one click away inside the page.

Gallery isn't on Notion's list of views that support conditional color; the property help names Table, Calendar, Timeline, List, Board and Feed. If state matters on a card, show the Status property as text, and keep color rules for the views that accept them, as described in setting conditional color for each database view.

Sort, filter, group and open cards

To reorder by hand, click and hold a card, then drag it left, right, up or down. For an order that follows a rule, the view settings offer Filter, Sort, Group and Sub-group per view, and a filter or sort can be saved for everyone or kept for you alone. Notion's gallery guide groups a team directory by one of the members' properties, and that's a sensible first group: Team or Department, with a Sub-group only if a second split helps someone find a person faster.

Clicking a card opens its page. Gallery layouts open pages in center peek by default; change that in Layout → Open pages in, which offers Side peek, Center peek and Full page. I'd pick Full page for records with long content, like a recipe or a case study, where a center modal gets cramped.

Placement is the last choice. To make a full-page database inline, drag it from the sidebar into another page, open that parent page, click ⋮⋮ next to the database sub-page and select Turn into inline. To go the other way, drag the inline database block into the sidebar as a top-level page. Once a shared directory's layout is right, Notion's gallery guide suggests locking the database to prevent accidental changes, and what a database lock protects compared with a page lock explains which one fits.

Three gallery setups and their settings

Notion's gallery help lists use cases such as a recipe collection, a cafe directory, a board game tracker and a mood board. Most client-work galleries fall into three patterns, and each follows from the image-source rule above.

Gallery settings for three common setups
SettingMood boardTeam directoryAsset or screenshot library
Card previewPage coverFiles & media property “Photo”Files & media property, or Page content when every page opens with its image
Card sizeLargeMediumSmall or medium
Fit imageOffOff, with each face near the middle of its photoOn
NameHiddenShownShown
Visible propertiesNone, or one tagRole, Team, EmailType, Updated
Wrap all propertiesNot neededOnOn if file names run long
Organize byDragging cards by handGroup by TeamFilter by Type

Mood board. The cover is the content, so Page cover with large cards and the Name hidden. Fit image stays off for an even wall, which only works if every cover shares one ratio and is at least 1,500 px wide.

Team directory. A Photo property survives anyone editing the bio at the top of a person's page, and you can drag every headshot into the table in one pass. Medium cards leave room for Role, Team and Email, Wrap all properties keeps long addresses readable, and headshots taken with the face near the middle survive the crop.

Asset or screenshot library. Logos, screenshots and posters come in different shapes, so Fit image goes on and nothing important is cropped away. Small or medium cards with Type and Updated visible make the grid quick to scan, and a Type filter saved for everyone gives the whole team the same view. If a client opens this library, share only the records meant for them; what to show in a Notion client portal covers where those records live and who gets in.

Choose a gallery when people recognize a record by its picture: a face, a cover, a screenshot. Choose a board when records move between stages and the grouping is the point; Notion's board view groups items by a property, and building a Notion kanban board covers columns and WIP limits. Choose a table when you compare or edit properties across many records, since every property gets its own column. For work tied to dates, a Notion timeline view plots each page across its dates. One database can hold all of these views at once, and choosing a Notion database view by the question it answers walks through that decision.

Add images inside a card's page

Each card has its own page, and images inside it work like images anywhere in Notion. Type /image and press Enter, then upload a file, embed one from its URL, or add a stock photo from Unsplash. To resize, hover over the image and drag one of the two black guides on its left or right edge. Hover and open ••• for Crop image, Alt text and Replace.

With the view on Page content, an image works as the card's picture only while it's the page's first block. For a link out of Notion, hover over an image and select ••• or ⋮⋮ → Add link, then paste a URL or pick a Notion page; Notion's image help notes that choosing a Notion page as the destination won't create a backlink. The card itself still opens its own page in the Open pages in mode, so an outbound link belongs on an image inside that page. For a public portfolio, publishing the page is a separate step with its own settings and limits, covered in publishing a Notion website.

Gallery cards look wrong? Check these first

Start with one view and one image rule

Set the image source first and everything else gets easier. I'd add one gallery view to the existing database, choose Files & media for directories and libraries or Page cover for mood boards, fill five records, and check the crop at the card size you want before adding the rest. Once those five look right, the remaining cards follow the same rule, and the checklist above catches the ones that don't.

Choose the next view