`offset` CSS property

Baseline Widely available

This feature is well established and works across many devices and browser versions. It's been available across browsers since September 2022.

The offset CSS shorthand property sets all the properties required for animating an element along a defined path. The offset properties together help to define an offset transform, a transform that aligns a point in an element (offset-anchor) to an offset position (offset-position) on a path (offset-path) at various points along the path (offset-distance) and optionally rotates the element (offset-rotate) to follow the direction of the path.

Note: Early versions of the spec called this property motion.

Try it

offset: path("M 20 60 L 120 60 L 70 10 L 20 60") 0% auto 90deg;

offset: path(
    "M 20 210 L 74 210 L 118 140 \
 L 62 140 L 20 210"
  )
  20% auto;

<section class="default-example" id="default-example">
  <div class="wrapper">
    <div id="example-element"></div>
  </div>
  <button id="playback" type="button">Play</button>
</section>

#example-element {
  width: 24px;
  height: 24px;
  background: #2bc4a2;
  clip-path: polygon(0% 0%, 70% 0%, 100% 50%, 70% 100%, 0% 100%, 30% 50%);
  animation: distance 3000ms infinite normal ease-in-out;
  animation-play-state: paused;
}

#example-element.running {
  animation-play-state: running;
}

.wrapper {
  height: 220px;
  width: 200px;
  background:
    url('data:image/svg+xml;utf8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 150 140" width="200" height="140"><path d="M 0 60 L 100 60 L 50 10 L 0 60" fill="none" stroke="lightgrey" stroke-width="2" stroke-dasharray="4.5"/></svg>')
      no-repeat,
    url('data:image/svg+xml;utf8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 -140 150 230" width="200" height="230"><path d="M 0 70 L 56 70 L 98 0 L 42 0 L 0 70" fill="none" stroke="lightgrey" stroke-width="2" stroke-dasharray="4.5"/></svg>');
}

@keyframes distance {
  to {
    offset-distance: 100%;
  }
}

#playback {
  position: absolute;
  top: 0;
  left: 0;
  font-size: 1em;
}

const example = document.getElementById("example-element");
const button = document.getElementById("playback");

button.addEventListener("click", () => {
  if (example.classList.contains("running")) {
    example.classList.remove("running");
    button.textContent = "Play";
  } else {
    example.classList.add("running");
    button.textContent = "Pause";
  }
});

Constituent properties

This property is a shorthand for the following CSS properties:

Syntax

/* Offset position */
offset: auto;
offset: 10px 30px;
offset: none;

/* Offset path */
offset: ray(45deg closest-side);
offset: path("M 100 100 L 300 100 L 200 300 z");
offset: url("arc.svg");

/* Offset path with distance and/or rotation */
offset: url("circle.svg") 100px;
offset: url("circle.svg") 40%;
offset: url("circle.svg") 30deg;
offset: url("circle.svg") 50px 20deg;

/* Including offset anchor */
offset: ray(45deg closest-side) / 40px 20px;
offset: url("arc.svg") 2cm / 0.5cm 3cm;
offset: url("arc.svg") 30deg / 50px 100px;

/* Global values */
offset: inherit;
offset: initial;
offset: revert;
offset: revert-layer;
offset: unset;

Formal definition

Initial value	as each of the properties of the shorthand: `offset-position` `offset-path` `offset-distance` `offset-anchor` `offset-rotate`
Applies to	transformable elements
Inherited	no
Percentages	as each of the properties of the shorthand: `offset-position` `offset-distance` `offset-anchor`
Computed value	as each of the properties of the shorthand: `offset-position` `offset-path` `offset-distance` `offset-anchor` `offset-rotate`
Animation type	as each of the properties of the shorthand: `offset-position` `offset-path` `offset-distance` `offset-anchor` `offset-rotate`

Formal syntax

offset = 
  [ <'offset-position'>? [ <'offset-path'> [ <'offset-distance'> || <'offset-rotate'> ]? ]? ]! [ / <'offset-anchor'> ]?

Examples

Animating an element along a path

HTML

<div id="offsetElement"></div>

CSS

@keyframes move {
  from {
    offset-distance: 0%;
  }

  to {
    offset-distance: 100%;
  }
}

#offsetElement {
  width: 50px;
  height: 50px;
  background-color: blue;
  offset: path("M 100 100 L 300 100 L 200 300 z") auto;
  animation: move 3s linear infinite;
}

Result

Specifications

Specification
Motion Path Module Level 1 # offset-shorthand

Browser compatibility

	Desktop					Mobile
	Chrome	Edge	Firefox	Opera	Safari	Chrome Android	Firefox for Android	Opera Android	Safari on iOS	Samsung Internet	WebView Android	WebView on iOS
`offset`	55 46	79 79	72	42 33	16	55 46	79	42 33	16	6.0 5.0	55 46	16
`auto`	116	116	122	102	16	116	122	78	16	24.0	116	16
`border-box`	116	116	122	102	16	116	122	78	16	24.0	116	16
`bottom`	116	116	122	102	16	116	122	78	16	24.0	116	16
`center`	116	116	122	102	16	116	122	78	16	24.0	116	16
`content-box`	116	116	122	102	16	116	122	78	16	24.0	116	16
`fill-box`	116	116	122	102	16	116	122	78	16	24.0	116	16
`left`	116	116	122	102	16	116	122	78	16	24.0	116	16
`margin-box`	No	No	No	No	16	No	No	No	16	No	No	16
`none`	61	79	72	48	16	61	79	45	16	8.0	61	16
`normal`	116	116	122	102	17	116	122	78	17	24.0	116	17
`padding-box`	116	116	122	102	16	116	122	78	16	24.0	116	16
`right`	116	116	122	102	16	116	122	78	16	24.0	116	16
`stroke-box`	116	116	122	102	16	116	122	78	16	24.0	116	16
`top`	116	116	122	102	16	116	122	78	16	24.0	116	16
`view-box`	116	116	122	102	16	116	122	78	16	24.0	116	16
`x-end`	No	No	No	No	26	No	No	No	26	No	No	26
`x-start`	No	No	No	No	26	No	No	No	26	No	No	26
`y-end`	No	No	No	No	26	No	No	No	26	No	No	26
`y-start`	No	No	No	No	26	No	No	No	26	No	No	26