Collect artwork and custom order fields
Ask for a purchase reference, requested date or private artwork and keep staff-only details on the order.
Browse guides
On this page
Choose where the value belongs#
Under Blueprints → Sellissimo, use Order fields for a value shared by the purchase, such as a purchase-order number. Use Line item fields for a value attached to one purchased item, such as print artwork. Configure the label and validation. The storefront and draft editor support text, textarea, integer, date, toggle, select, radio and single-file assets fields. Hidden and read-only fields are available to staff on drafts. Buyer responses and packing slips omit them. Check the buyer’s form and packing slip after saving.
Use the product’s Personalization grid for buyer-entered choices such as engraving. Different choices can create separate lines for the same SKU. In the bundled cart, Edit choices retains existing artwork and quantity while the buyer edits. Identical configurations can merge.
Send fields from a custom checkout#
Send line_fields on the cart-item request and order_fields on the quote and checkout requests. For an edit, send the original line_key along with the SKU, quantity and the changed fields or options. Omitted choices are retained.
For an upload, POST multipart form data to /api/sellissimo/v1/carts/{cart}/artwork with the buyer’s session, CSRF token and guest cart token when applicable. Send type (line or order), the configured field handle, and file. Use the returned id as that field’s value. Artwork accepts PDF, JPEG, PNG and WebP files up to 10 MiB. A file belongs to the cart and field that received it. Staff retrieve it from the owning order.
Update internal details after purchase#
Grant Edit staff-only order fields and open Edit staff fields on the order. Update the internal value and save. Each change is validated and recorded in order activity. If another staff member saved first, reopen the order and review the latest values. The buyer keeps the fields recorded on their purchase.
To connect another Statamic entry, such as a warranty claim, add the Sellissimo orders relationship field to its blueprint. Staff with order access can search for an order and open it from the entry.