The Dimension Control feature allows you to validate files uploaded by customers before they are added to the cart. By defining specific logic rules, you can check file properties such as width, height, resolution (DPI), or page count to ensure the uploaded assets meet your production requirements.
Note: Currently, this feature strictly supports PNG image files and PDF documents only.
How to Enable
Navigate to the Dimensions section in the settings panel.
Check the box labeled Enable dimension control.
Once enabled, you can click + Create Condition (or "Add condition") to begin defining your validation rules.
Configuration Settings
Important Logic: When setting these fields, you are defining the condition that causes the error. If the uploaded file matches your condition, the "Action" (Prevent or Warning) will be triggered.
1. Type
This determines the specific property of the file that the system will inspect.
Pixel Width / Pixel Height: Checks the digital resolution (px).
Inch Width / Inch Height: Checks the physical print size (in).
Centimeter Width / Centimeter Height: Checks the physical print size (cm).
Image DPI: Checks the resolution density (dots per inch).
PDF Page Count: Checks the total number of pages (for PDF files only).
2. Operator
This defines the mathematical logic used to trigger the rule.
Greater than: Triggers if the file property is larger than the value provided.
Less than: Triggers if the file property is smaller than the value provided.
Equal: Triggers if the file property matches the value exactly.
Not Equal: Triggers if the file property is anything other than this specific value.
3. Value
The numeric threshold used for the comparison.
Example: If you select
Inch Width>Greater than>22and set the action toPrevent, the system will block any image that is wider than 22 inches.
4. Rounding
Controls how the system handles decimal measurements in the uploaded file before comparing.
Enable: Rounds the uploaded file's dimensions to the nearest whole number (e.g.,
22.1becomes22).Disable: Compares the exact decimal value.
5. Action
Determines what happens when the condition is met (i.e., when the "error" is found).
Prevent: The user is blocked from adding the product to the cart. Use this for strict limits (e.g., "File Inch width is greater than 22 in").
Warning: The user sees a warning message but can still proceed. Use this for soft recommendations.
6. Target
Specifies which product variants this rule applies to.
All Variants: The rule applies to every version of the product.
Target Variant: The rule applies only to the specific variant of the product
Pro Tip: Ensuring Print Quality (300 DPI)
If you operate in the printing industry, ensuring high-resolution uploads is critical for maintaining output quality. Low-resolution images often result in pixelated or blurry prints.
We highly recommend adding a specific rule to enforce the industry standard for print resolution.
Recommended Configuration:
Type: Image DPI
Operator: Less than
Value: 300
Action: Prevent
Why this matters: By setting this rule, the system will automatically block any file that does not meet the 300 DPI standard, ensuring you only receive files capable of producing crisp, high-quality prints.
