Managing images

List view

Managing images in Notion

Any image that you upload in Notion will be optimized before rendering in the website.

How Bullet optimizes images in the background?

The images you upload in Notion will be automatically converted into WebP and AVIF format. If the requesting browser supports AVIF we deliver the image in AVIF format. If the browser does not support AVIF, images will fall back to WebP. And if there is no support for WebP, then we will serve compressed files in the original format.
 

Converting images as Links.

You can add link to images so users navigate to a specific URL. To hyperlink an image:
  1. Hover over the image and click •• or ⋮⋮.
  1. Select Add link →Paste a URL or choose a Notion page.
 
Note that selecting a Notion page won't create a backlink.
 

Adding alt text for images.

Alt Text is a short description added to images for accessibility and SEO purposes.
 
Alt text is a brief description added to images, primarily for accessibility. Adding alt text ensures better accessibility, enhances search rankings.
  • Hover over the image and click the •• (three dots) menu.
  • Select Alt text → Enter a description → press Enter to save.
 
However, if you want have an alt text, and still have a link or if you want a different image caption than that of alt text, then follow the advanced image control attributes below.

Advanced image control attributes

You can use advanced image attributes inside of image caption. These image control attributes, while not visible on the website, serve as meta properties that enable precise image management.
Some of the attributes are:
notion image
 
  • :height=”120px”
    • Change the height of the image
  • :width=”180px”
    • Change the width of the image
  • :loading=”eager”
 
Remember these image attributes will be given in the image caption of your Notion page , but they won't show up on your website.