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

# Interface: ISafetyLine

> A structure holding settings for a safety line.

## Remarks

For details, see the [Bleed and Safety Zones](https://customerscanvas.com/dev/editors/iframe-api/product-definition/bleeds-and-safety-zone.html) topic.

## 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)',
               borderRadius: "10",
               stepPx: 5,
               widthPx: 1,
               pdfBox: "Trim"
           }]`
       }]
   }]
};
```

## Properties

### name?

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

The name of the safety line.

***

### margin?

> `optional` **margin?**: `number` \| [`IMarginHV`](https://customerscanvas.com/docs/on-premises/design-editor/iframe-api/reference/design-editor-iframe/interfaces/ObjectModel.IMarginHV.md) \| [`IMarginLTRB`](https://customerscanvas.com/docs/on-premises/design-editor/iframe-api/reference/design-editor-iframe/interfaces/ObjectModel.IMarginLTRB.md)

The distance between the safety line and the print area bounds, in points. The default value is `10` pt.

***

### color?

> `optional` **color?**: `string`

The main color; a CSS-style color value. The default value is <code>"rgba(255,255,255,1)"</code>.

***

### altColor?

> `optional` **altColor?**: `string`

The alternate color; a CSS-style color value. The default value is <code>"rgba(0,0,0,1)"</code>.

***

### stepPx?

> `optional` **stepPx?**: `number`

The dash length in pixels; the safety line is always a dashed line. The default value is `10` px.

***

### widthPx?

> `optional` **widthPx?**: `number`

The line width, in pixels. The default value is `1` px.

***

### borderRadius?

> `optional` **borderRadius?**: `string`

The definition of rounded corners in the CSS format. You can set up the radius in points, in percent, or through the width and height of ellipses. By default, the safety zone is not rounded.

***

### pdfBox?

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

The rectangle to wich the hi-res outputs are cropped: to CropBox, TrimBox, or BleedBox. By default, resulting PDF images are not cropped. Design Editor applies margins of the safety line to the corresponding PDF page box.