How to size images by percent in Obsidian

As of October 2026, Obsidian reads a size in an image embed as pixels only. A size of |300 after the file name is 300 pixels wide on every screen. A plugin can read percent, em, rem, vw and vh in the same place.

Relative Image Width has Pro, and $15 one time turns it on in all 129 plugins.

Background

The forum request for relative image sizes opened on 20 April 2021. It asks for sizes such as |50% and |70em after the image name, and for Pandoc attributes. A pixel width that looks right on a laptop can be too wide on a phone.

2 ways to do it

  1. The core pixel size in the link

    Add |640x480 after the file name of an image embed to set its width and height in pixels. If you give only the width, such as |100, the image scales in proportion.

    A Markdown image link to an external image takes the same size after its alt text.

    limits
    The Embed files help page names pixel sizes only. The plugin README says Obsidian ignores a size that is not a pixel number.
  2. Relative Image Width from this site

    Relative Image Width reads |50% after the file name of an image embed as half the text column. It also reads em, rem, vw and vh, and a box such as 50%x30%, in Live Preview and Reading view.

    A pixel size stays as Obsidian draws it. The plugin never writes to your notes. It only changes how the image looks.

    limits
    It sizes image embeds only, not note or PDF embeds. A default size for images without a size needs Pro.
    Reading view with three images at relative sizes of the text column and one image at a pixel size.
    Open larger

    MIT · no telemetry · core features free

    All features of Relative Image Width

Size an image by percent with Relative Image Width

  1. Open Settings, then Community plugins, and turn off restricted mode.

  2. Select Browse, search for Relative Image Width, then select Install and Enable. It needs Obsidian 1.13.4 or later.

  3. Embed an image as usual, then add | and a size with a unit after the file name, such as photo.png|50%.

  4. Read the note in Live Preview or Reading view. The image now takes half of the text column.

  5. To read Pandoc blocks such as {width=50%} after a link, turn on Read Pandoc attributes in the plugin settings.

Common questions

Which units can an Obsidian image link use with the plugin?

Relative Image Width reads percent, em, rem, vw and vh. A number without a unit stays pixels, and Obsidian sizes it as before. A percent height is a percent of the window height.

Why does my image stay full width?

The size must be the last part of the link, with no space between the number and the unit. Write 50%, not 50 %. An image also cannot get wider than the text column.

Can one note give all its images a default width?

Relative Image Width Pro adds a default size for images that have no size in the link. The note property image-width sets that default for one note. A size in the link wins over both.

Photo of Michael LipYou can now size images by percent.

This guide uses Relative Image Width. Pro adds "Default size for a note". One payment of $15 turns on Pro in 129 plugins.