Uploading Files

Files can be uploaded in two ways:

• Direct upload - Use the Assets table in the Manager to upload standalone files. Each asset has a name, description, file attachment, and status.
• Inline upload - When editing a product, article, slide, or other record, file fields have built-in upload controls. These files are attached directly to the record rather than managed as standalone assets.

Uploaded files are stored in Vercel Blob Storage and served through a CDN for fast global delivery.

Supported Formats

The platform accepts most common file types. Each file field may specify additional constraints via its accept validation. Common supported types include:

• Images - JPEG, PNG, WebP, GIF, SVG
• Fonts - WOFF, WOFF2, TTF, OTF (for custom typography in Site Config)
• Documents - PDF
• Icons - ICO, SVG, PNG (for favicons)
• Video - MP4, WebM (where configured)

Size Limits

Each file field defines a maximum upload size via its mbLimit validation. Typical limits:

• Avatars - 1 MB
• Product images - 2-5 MB per image
• Slide images - 5 MB
• Logos & favicons - 2 MB
• Font files - 2 MB

The platform validates file size before upload. Files exceeding the limit are rejected with a validation error and are not stored.

Placeholders & Fallbacks

The platform uses configurable fallback images when no file has been uploaded. These are set in Site Config > Placeholders and include defaults for missing avatars, product images, and hero banners. This ensures the site never displays broken image links.

API Access

File and image fields are read-only via the external API. You can read file URLs from records but cannot upload files through the API. All file uploads must go through the CMS Manager.