---
source: https://carbone.io/documentation/design/advanced-features/transform.html
title: "Move items in a page on X or Y axis"
description: "Move items in a page on X or Y axis"
generated_at: "2026-07-13"
---

# Transform

Move items in a page on X or Y axis  
ENTERPRISE FEATURE Available for:  
✓ Carbone Cloud  
✓ Carbone On-premise  
✗ Embedded Carbone JS   v4.22.11+ 

> ℹ️ **Note:** Compatible with ODT, ODP, PPTX, and PDF files.

The feature is available only if the tag `{o.preReleaseFeatureIn=4022011}` is used.

## Overview

Some template types (slideshow, presentation, drawing) use items which are positioned in an absolute manner with an X or Y position relative to the current page, slide, paragraph, etc.

Carbone can move these items on X or Y axis with `:transform(axis, unit)` formatter:

-   `axis` can be `x` or `y` to move the item horizontally or vertically from its current position. Positive numbers = move to the right or bottom, Negative number = move to the left or top.
-   `unit` can be `cm`, `mm`, `inch`, `pt` or `in` (`in` only for ODP and PPTX).

This tag must be placed inside the item to move. It prints nothing by itself.

-   in the alternative text of a shape, an image
-   in the shape itself

> ⚠️ **Warning:** if a loop is created between two shapes, the `[i+1]` tag must be in the shape that is higher in the layer order than the shape with the `[i]` tag.

Get inspired by one of our real-life examples: [Dynamic Pins on a Map](/examples/dynamic-pins-on-map/index.md), [Grid Layout](/examples/matrix-pptx/index.md) or [Property advertisement](/examples/real-estate-property-description/index.md)

## PPTX example

**Data**

```json
{
  "pos" : 4
}
```

**Template**

![Template with transform tag in the alternative text](/img/doc/transform-template.webp)

**Result**

![Result with Carbone](/img/doc/transform-result.webp)

## Related topics

- [Translations i18n](/documentation/design/advanced-features/translations-i18n.md)
- [Digital signatures](/documentation/design/advanced-features/signatures.md)
- [Pictures](/documentation/design/advanced-features/pictures.md)
- [Pagination](/documentation/design/advanced-features/pagination.md)
- [Key-value mapping](/documentation/design/advanced-features/key-value-mapping.md)
- [Hyperlinks](/documentation/design/advanced-features/hyperlinks.md)