---
title: "Interface: IPrintAreaDefinition | Customer's Canvas On-Premises"
canonical: "https://customerscanvas.com/docs/on-premises/design-editor/iframe-api/reference/design-editor-iframe/interfaces/ObjectModel.IPrintAreaDefinition/"
---

# Interface: IPrintAreaDefinition

> A structure used for creating an empty print area.

## Example

``` js
// Defining the product.
let w = 720, h = 504; // in points (1 point = 1/72 inch)

let emptyProduct = {
   surfaces: [{
       width: w,
       height: h,
       printAreas: [{
           bounds: {
               x: 0, y: 0, width: w, height: h
           },
           safetyLines: `[{
               margin: 8.5,
               color: 'rgba(0,255,0,1)',
               stepPx: 5,
               widthPx: 1 
           }]`
       }]
   }]
};
```

## Extends

- [`IBasePrintAreaDefinition`](https://customerscanvas.com/docs/on-premises/design-editor/iframe-api/reference/design-editor-iframe/interfaces/ObjectModel.IBasePrintAreaDefinition.md)

## Properties

### name?

> `optional` **name?**: `string`

A name of a surface (a page) in the product.

#### Remarks

In multipage products, it allows you to use a name mask for product surfaces. If this string contains the `{0}` placeholder, it will be replaced with a page number, starting from `1`. For example, `name: "Page {0}"` specifies the following page captions in the Bottom toolbar: `Page 1`, `Page 2`, and so on.

#### Inherited from

[`IBasePrintAreaDefinition`](https://customerscanvas.com/docs/on-premises/design-editor/iframe-api/reference/design-editor-iframe/interfaces/ObjectModel.IBasePrintAreaDefinition.md).[`name`](https://customerscanvas.com/docs/on-premises/design-editor/iframe-api/reference/design-editor-iframe/interfaces/ObjectModel.IBasePrintAreaDefinition.md#name)

***

### safetyLines?

> `optional` **safetyLines?**: [`ISafetyLine`](https://customerscanvas.com/docs/on-premises/design-editor/iframe-api/reference/design-editor-iframe/interfaces/ObjectModel.ISafetyLine.md)[]

A collection of safety lines defined in the print area.

#### Inherited from

[`IBasePrintAreaDefinition`](https://customerscanvas.com/docs/on-premises/design-editor/iframe-api/reference/design-editor-iframe/interfaces/ObjectModel.IBasePrintAreaDefinition.md).[`safetyLines`](https://customerscanvas.com/docs/on-premises/design-editor/iframe-api/reference/design-editor-iframe/interfaces/ObjectModel.IBasePrintAreaDefinition.md#safetylines)

***

### cropMarks?

> `optional` **cropMarks?**: [`ICropMark`](https://customerscanvas.com/docs/on-premises/design-editor/iframe-api/reference/design-editor-iframe/interfaces/ObjectModel.ICropMark.md)[]

A collection of crop marks defined in the print area.

#### Inherited from

[`IBasePrintAreaDefinition`](https://customerscanvas.com/docs/on-premises/design-editor/iframe-api/reference/design-editor-iframe/interfaces/ObjectModel.IBasePrintAreaDefinition.md).[`cropMarks`](https://customerscanvas.com/docs/on-premises/design-editor/iframe-api/reference/design-editor-iframe/interfaces/ObjectModel.IBasePrintAreaDefinition.md#cropmarks)

***

### containers?

> `optional` **containers?**: [`IChannelContainerDefinition`](https://customerscanvas.com/docs/on-premises/design-editor/iframe-api/reference/design-editor-iframe/interfaces/ObjectModel.IChannelContainerDefinition.md)[]

A collection of texture and spot color containers defined in the print area.

#### Remarks

For backward compatibility only!

#### Inherited from

[`IBasePrintAreaDefinition`](https://customerscanvas.com/docs/on-premises/design-editor/iframe-api/reference/design-editor-iframe/interfaces/ObjectModel.IBasePrintAreaDefinition.md).[`containers`](https://customerscanvas.com/docs/on-premises/design-editor/iframe-api/reference/design-editor-iframe/interfaces/ObjectModel.IBasePrintAreaDefinition.md#containers)

***

### bleed?

> `optional` **bleed?**: `IMargin`

Margins of the bleed area.

#### Inherited from

[`IBasePrintAreaDefinition`](https://customerscanvas.com/docs/on-premises/design-editor/iframe-api/reference/design-editor-iframe/interfaces/ObjectModel.IBasePrintAreaDefinition.md).[`bleed`](https://customerscanvas.com/docs/on-premises/design-editor/iframe-api/reference/design-editor-iframe/interfaces/ObjectModel.IBasePrintAreaDefinition.md#bleed)

***

### slug?

> `optional` **slug?**: `IMargin`

Margins of the slug area. The editor expands the product boundaries to accommodate the slug area.

#### Inherited from

[`IBasePrintAreaDefinition`](https://customerscanvas.com/docs/on-premises/design-editor/iframe-api/reference/design-editor-iframe/interfaces/ObjectModel.IBasePrintAreaDefinition.md).[`slug`](https://customerscanvas.com/docs/on-premises/design-editor/iframe-api/reference/design-editor-iframe/interfaces/ObjectModel.IBasePrintAreaDefinition.md#slug)

***

### hiResOutput?

> `optional` **hiResOutput?**: [`IHiResOutput`](https://customerscanvas.com/docs/on-premises/design-editor/iframe-api/reference/design-editor-iframe/interfaces/ObjectModel.IHiResOutput.md)

Properties of the hi-res output defined in the print area.

#### Inherited from

[`IBasePrintAreaDefinition`](https://customerscanvas.com/docs/on-premises/design-editor/iframe-api/reference/design-editor-iframe/interfaces/ObjectModel.IBasePrintAreaDefinition.md).[`hiResOutput`](https://customerscanvas.com/docs/on-premises/design-editor/iframe-api/reference/design-editor-iframe/interfaces/ObjectModel.IBasePrintAreaDefinition.md#hiresoutput)

***

### bounds

> **bounds**: [`IRectangleF`](https://customerscanvas.com/docs/on-premises/design-editor/iframe-api/reference/design-editor-iframe/interfaces/ObjectModel.IRectangleF.md)

The print area bounds.