Responsive Image Markup Planner

Edit image candidates and viewport rows, then review escaped responsive markup.

On-device No sign-up Free to use

Plan image markup controls

?

Enter actual intrinsic widths, not desired CSS widths. All candidates must show the same composition and use one format.

?

Processed in your browser. Your inputs stay on this device.

Showing an example. Change the fields, then use plan image markup to update it.

Result

Showing an example.

Compare 400-, 800- and 1,600-pixel candidates with three layout scenarios at DPR 2.

3 width candidates; 3 viewport scenarios.

Loading the tool. Your result will appear here.

https://usefreetools.net/responsive-image-markup-planner · 20 November 2026

Was this helpful?

How to use Responsive Image Markup Planner

  1. Enter existing image URLs and actual intrinsic widths in candidate rows or advanced JSON. Keep one format and composition across the set.
  2. Optionally use a URL pattern containing one {width} and a width list, then choose Fill candidate rows. Review any replacement confirmation; the files must already exist.
  3. Enter viewport breakpoints and CSS slot widths, the width above the last breakpoint, a scenario DPR and useful alternative text.
  4. Review the updated markup and candidate table, then download them if needed. Verify real rendered slots and browser selection separately.

Example: Responsive Image Markup Planner

Compare 400-, 800- and 1,600-pixel candidates with three layout scenarios at DPR 2.

You add
Image candidates (JSON): [ { "url": "/small.jpg", "width": 400 }, { "url": "/medium.jpg", "width": 800 }, { "url": "/large.jpg", "width": 1600 } ]; Viewport slots (JSON): [ { "maxViewport": 600, "slot": 360 }, { "maxViewport": 1200, "slot": 720 } ]; Slot width above final breakpoint (CSS pixels): 960; Scenario device pixel ratio: 2; Image alternative text: An entered sample photograph
You get
3 width candidates; 3 viewport scenarios.

Options

Intrinsic width
Enter the candidate’s real pixel width. The tool does not open images to confirm it.
Slot and DPR
The table compares slot width multiplied by DPR with the entered candidates. This is a planning model rather than a browser choice guarantee.
Image candidates (JSON)
Enter actual intrinsic widths, not desired CSS widths. All candidates must show the same composition and use one format.

Supported inputs and limits

  • Up to 30 distinct candidate widths from 1–30,000 pixels and 20 viewport slots from 1–10,000 CSS pixels.
  • Fallback width is 1–10,000; scenario DPR is 0.5–4.
  • URLs must use supported HTTP(S)/relative forms with whitespace and commas encoded.
  • The model selects the smallest entered width meeting slot × DPR, or the largest available and marks a shortfall.
  • No image fetch/resize, art direction, format fallback, encoded-byte estimate or guaranteed browser choice.

Where your input is processed

This tool does not upload your inputs. See the limits for anything saved on your device.

The declared slot must match your layout

A correct srcset can still accompany an inaccurate sizes value. Check the rendered slot at relevant viewports and keep each candidate’s composition consistent. Browsers can account for network conditions, caching and user preferences when choosing a source.

Questions about Responsive Image Markup Planner

Does it resize my images?

No. It prepares markup for candidates you already have.

Is the suggested candidate guaranteed?

The table uses its declared width model; browsers may choose differently.

Can I enter mixed crops?

Use a coherent composition; art-direction picture markup is outside this planner.

Page updated · Project managed by Tony Hines · Report a problem with Responsive Image Markup Planner