translate()

Published Jul 7, 2021Updated Feb 27, 2022
Contribute to Docs

The translate function moves an element along the X- and/or Y-axis.

Syntax

The required <X-value> or <Y-value> can be one of the following:

  • Length value: 100px, 1.5em
  • Percentage value: 25%, 50%
/* Single value */
transform: translate(<X-value>);

/* Double values */
transform: translate(<X-value>, <Y-value>);

A single value will represent only the horizontal axis. Providing a second comma-separated value will represent the vertical axis, as well. As far as the direction goes:

  • A positive value moves the element towards the right along the horizontal X-axis or down the vertical Y-axis.
  • A negative value moves the element left along the horizontal X-axis or up the vertical Y-axis.

Example 1

In the example below, an element with a .box class is moved 100px to the right, along the X-axis:

.box {
transform: translate(100px);
}

Example 2

In this example, the .box class element is moved 200px to the right, along the X-axis, and 100px up the vertical Y-axis.

.box {
transform: translate(200px, -100px);
}

Example 3

Move the .box element 100px down the vertical axis:

.box {
transform: translate(0, 100px);
}

All contributors

Looking to contribute?

Learn CSS on Codecademy