Cover Images

Show card previews from images in record descriptions, comments, or file custom fields.

Cover images show a visual preview on record cards. Blue gets the preview from the source configured for the workspace.

Enable and configure cover images

  1. Open Workspace Settings > Card Interface.
  2. Find Image Cover Options.
  3. Turn on Enable Cover Images.
  4. Choose an image source.
  5. Choose the first or last available image.
  6. Choose Cover or Contain for the image fit.

Blue saves the configuration for the workspace and processes its existing records. Cover images update when the source content or configuration changes.

Image Cover Options in the Card Interface settings

Image sources

Choose one source for the workspace:

  • Description: Uses images embedded in record descriptions. This is the default source.
  • Comments: Uses the first or last image from record comments.
  • Custom Field: Uses files from a selected file-type custom field. This source supports any file type.

If images are part of the record brief, select Description. Select Comments for images added during discussions, or Custom Field for a dedicated file field.

Image selection

If the source contains more than one image, choose which image Blue displays:

  • First Image: Uses the first image found. This is the default.
  • Last Image: Uses the most recent image.

Display fit

  • Cover: Fills the preview area. Blue can crop the image edges to keep its aspect ratio. This is the default.
  • Contain: Shows the complete image. The preview can contain empty space around it.

Use Cover when cropping is acceptable. Use Contain for diagrams or screenshots that must remain fully visible.

Processing existing records

Blue starts processing existing records when you enable cover images or save a configuration change.

  • Blue shows processing progress in real time.
  • Blue processes 50 records in each batch.
  • You can continue working during processing.
  • Blue refreshes the lists when processing finishes.

Supported files

For Description and Comments sources, Blue supports:

  • JPEG and JPG images
  • PNG images, including transparency
  • GIF images with a static preview

For a Custom Field source, Blue displays any file type. Images display as previews, and other files display their file-type icons.

Files must be uploaded to Blue. External image URLs are not supported.

Limits

  • Bulk cover generation supports up to 6,000 records in a workspace.
  • Only file-type custom fields can be cover sources.
  • Cover images are view-only. You cannot edit them directly.

Automatic updates

Blue regenerates covers after these changes:

  • The record description changes while Description is the source.
  • A comment with an image is added while Comments is the source.
  • Files change while Custom Field is the source.
  • The cover configuration changes.
  • The display fit changes.

API access

Cover images are available through the GraphQL API:

  • Configure covers with the setTodoCoverConfig mutation.
  • Read cover data from the cover field on the Todo type.
  • Monitor processing with the subscribeToCoverGenerationProgress subscription.
  • Use automatically generated thumbnail URLs at /uploads/{uid}/thumbnail/cover.
  • Images submitted through Forms can become cover images.
  • The API supports cover configuration and cover data.
  • Any File custom field can be a cover source.