Configuring Upload Settings in Konfiwear
Upload settings control what your customers can do when placing freeform graphics in the customizer — file size limits, formats, scale constraints, rotation, and how many graphics they can add.
Prerequisites
⚠️ Important: You need admin or owner access to your Konfiwear account. Upload settings are account-wide — they affect all products and all customers using your customizer.
Navigating to Upload Settings
Go to Graphics → Upload Settings from the sidebar tab navigation.
Unlike Zones and Link Groups (which use data tables), Upload Settings is a single form — there's only one configuration per account.
Caption: The Upload Settings form with all configurable fields.
Settings Reference
Allow User Uploads
Setting | Default | Description |
Allow User Uploads | On | Master toggle. When off, customers cannot upload any graphics to the customizer. They can still select from your graphic library (if configured). |
⚠️ Important: Turning this off disables freeform graphic uploads globally. Customers will only be able to use graphics from your Graphic Library or content within defined graphic zones.
File Size Limit
Setting | Default | Description |
Max File Size | 5 MB (5120 KB) | The maximum file size a customer can upload. Files exceeding this limit are silently rejected. |
Set this based on your production requirements. Larger files provide higher resolution but slow down the customizer. For most print workflows, 5–10 MB covers high-quality raster images.
Allowed File Types
Visual toggle cards with file-extension icons. Each card represents a file format that customers can upload:
Format | Default | Typical Use |
PNG | Allowed | Raster images with transparency — logos, badges, artwork |
JPG / JPEG | Allowed | Photographic images — team photos, complex artwork |
SVG | Allowed | Vector graphics — crisp at any scale, recolorable |
WebP | Allowed | Modern efficient format with transparency |
AI | Not allowed | Adobe Illustrator files — enable for design-savvy customers |
EPS | Not allowed | Encapsulated PostScript — legacy vector format |
Not allowed | Portable documents — enable if your production accepts PDF artwork |
Click a card to toggle the format on or off.
💡 Tip: For most sportswear customizers, PNG + JPG + SVG covers the vast majority of customer uploads. Add AI/EPS/PDF only if your production pipeline handles those formats directly.
Freeform Graphics Limit
Setting | Default | Description |
Max Freeform Per Config | Unlimited (null) | Maximum number of freeform graphics a customer can place on a single configuration. Set to a number to cap it (e.g., |
This prevents customers from overloading a design with too many freeform graphics, which can degrade print quality and customizer performance.
Scale Constraints
Two slider fields controlling how much customers can scale their graphics:
Setting | Default | Range | Description |
Min Scale | 0.1 (10%) | 0.01 – 1.0 | Smallest allowed size. Prevents graphics from becoming too tiny to print. |
Max Scale | 3.0 (300%) | 1.0 – 10.0 | Largest allowed size. Prevents graphics from exceeding print bounds or becoming pixelated. |
💡 Tip: A min scale of 0.1 and max scale of 3.0 works for most use cases. If you want to prevent customers from scaling down too far (losing print resolution), increase the minimum to 0.25.
Interaction Permissions
Two side-by-side toggles:
Setting | Default | Description |
Allow Rotation | On | Whether customers can rotate their placed graphics. Turn off to lock graphics at their original angle. |
Allow Drag | On | Whether customers can reposition their placed graphics. Turn off to lock graphics at their initial placement point. |
⚠️ Important: Turning off Allow Drag means graphics stay exactly where they are first placed (via 3D click-to-place). This is useful for fixed promotional placements but removes customer flexibility.
Save the Settings
Click Save at the bottom of the form. Settings are saved via an upsert — if no settings exist for your account yet, they're created. If they already exist, they're updated.
Changes take effect in the customizer immediately after saving — no additional deployment or cache clearing needed.
✅ Done! Your upload settings are configured. All customers using your customizer will see these constraints applied to their freeform graphic uploads.
How Upload Settings Interact with Zone Constraints
Upload settings are global defaults for freeform graphics. Graphic zones have their own per-zone constraints that can be more restrictive:
Aspect | Upload Settings (Global) | Zone Constraints (Per-Zone) |
Scope | All freeform graphics across all products | Graphics placed within a specific zone only |
File size | Max 5 MB (default) | Max 10 MB (default) — zone-specific override |
Formats | Account-wide format list | Per-zone format list |
Scale | Min/max scale for freeform placement | N/A — zones auto-scale to fit (DTG) |
Upload permission | Master toggle ( | Per-zone |
If both apply (e.g., a freeform graphic and a zone upload), the more restrictive setting wins for file size and formats.
Tips & Best Practices
Start with defaults — the out-of-the-box settings work for most sportswear customizers
Enable SVG — vector graphics scale perfectly and produce the crispest prints
Set a freeform limit for production sanity — 3–5 freeform graphics per config prevents customers from creating unmanufacturable designs
Keep max scale at 3.0 unless you have a specific reason to change it — larger scales make raster images pixelated
Disable rotation if garment symmetry matters — some production methods require all graphics at 0° rotation
Review upload settings with your production team — they know which formats, resolutions, and file sizes work with your printing equipment