---
title: "translate | Customer's Canvas On-Premises"
canonical: "https://customerscanvas.com/docs/on-premises/ui-framework/widgets/design-editor-commands/translate/"
---

# translate

> This command moves design items on the canvas.

For more details, refer to the [Command Manager](https://customerscanvas.com/docs/on-premises/design-editor/iframe-api/howto/resizing-designs.md#moving-design-elements) topic.

## Params

- `items` - an array of item names. 
- `translateX` - the distance to move the items along the X-axis, in either points or percent relative to the print area. For example, `72` or `"10%"`. 
- `translateY` - the distance to move the items along the Y-axis, in either points or percent relative to the print area. For example, `72` or `"10%"`. 

For the complete list of parameters, you can refer to [IDesignEditorDefinitionTranslateItems](https://customerscanvas.com/docs/on-premises/ui-framework/widgets/reference/au-widget-design-editor.IAuWidgetDesignEditor.md#idesigneditordefinitiontranslateitems).

## Example of the config

```json
  {
    "type": "design-editor", 
    "name": "editor",
    "params": {
      "initial": { ... }, 
      "translate": {
        "translateParams": {
          "items": ["photo"],
          "translateX": "10",
          "translateY": "10"
        }
      }
    }
  }
```