---
title: "Config Reference | Customer's Canvas Hub"
canonical: "https://customerscanvas.com/docs/hub/admin-guide/workflows/ui-framework/widgets/preflight/config/"
---

# Config Reference

> This page provides a summary of the key configuration options for the Preflight widget. For the complete reference, see the [On-premises documentation](https://customerscanvas.com/docs/on-premises/preflight/reference/config/).

## Key Configuration Objects

### Product Properties

| Property | Type | Description |
|----------|------|-------------|
| `product.dpi` | number | Output resolution in DPI (default: 300) |
| `product.size.width` | number | Product width in points (1 point = 1/72 inch) |
| `product.size.height` | number | Product height in points |
| `product.pages` | number \| object | Number of pages or page limits (init/min/max) |
| `product.bleed` | number | Bleed zone in points |
| `product.allowAddPages` | boolean | Allow users to add pages |
| `product.allowDeletePages` | boolean | Allow users to delete pages |

### File Uploader

| Property | Type | Description |
|----------|------|-------------|
| `uploader.fileTypes` | string[] | Allowed file extensions. Supported: `".pdf"`, `".ai"`, `".bmp"`, `".eps"`, `".gif"`, `".jpg"`, `".jpeg"`, `".png"`, `".psd"`, `".tiff"` |
| `uploader.multiple` | boolean | Enable multiple file selection |
| `uploader.initialMode` | string | How to fit uploaded files. Values: `"fitToBleed"`, `"fitToTrim"`, `"fillToTrim"`, `"fillToBleed"`, `"default"` |
| `uploader.fileUploadBehavior` | string | How to place files. Values: `"replaceFull"`, `"insertCurrent"`, `"insertNew"` |
| `uploader.fileMaxSize` | number | Maximum file size in bytes (default: 536870912) |

### Validation Rules

| Property | Type | Description |
|----------|------|-------------|
| `rules[].type` | string | Rule type. Values: `"colorspace"`, `"spotcolors"`, `"resolution"`, `"safetyboxes"`, `"nomargins"`, `"insideBleedbox"`, `"sameorientation"`, `"forbiddenfonts"`, `"allowedfonts"`, `"fonttypes"`, `"minfontsize"`, `"textascurves"`, `"embeddedfonts"` |
| `rules[].severity` | string | `error` or `warning` |
| `rules[].enableFix` | boolean | Show Fix button for autofix |
| `rules[].pages` | number[] \| string[] | Target pages (e.g., `[1,3]` or `["/2"]` for every 2nd page) |
| `rules[].params` | object | Rule-specific parameters (e.g., `allowedColorSpaces` for colorspace rule) |

### Rendering

| Property | Type | Description |
|----------|------|-------------|
| `rendering.hiResOutputDpi` | number | Hi-res output DPI |
| `rendering.hiResOutputToSeparateFiles` | boolean | Separate files per page |
| `rendering.previewSize.width` | number | Preview width in pixels |
| `rendering.previewSize.height` | number | Preview height in pixels |

For the complete configuration reference with all available options, see the [Preflight configuration documentation](https://customerscanvas.com/docs/on-premises/preflight/reference/config/).