Images & Video and Warranty live inside the exact product editor but save differently. Gallery media requires an already-saved product and uploads immediately; it is not waiting for the main product Save. A new Warranty PDF is queued locally and uploads only during the main Save. The gallery’s upload, primary, delete, and reorder operations perform multiple storage/database calls with limited error checking, while warranty storage and product attachment are also separate writes. Verify the live product after every change.
Step by step
- Go to Products and open the exact product. Confirm name, product/variant identity, and SKU before changing media. Product media belongs to the parent product; variants can associate an existing parent product image elsewhere, but this gallery does not upload a separate variant-owned file.
- For a brand-new unsaved product, Images & Video shows Save the product first to upload images and videos. Complete the required product identity and choose Save. Reopen the saved product before uploading so every storage object has the intended product ID.
- Choose Upload media or the empty gallery upload area. Despite the empty-state text saying Click or drag, this component has no file-drop handler on that area; use the file picker. Multiple files can be selected in one picker action.
- Each accepted image/* file may be at most 2.5 MB and each video/* file at most 50 MB. Other MIME types and oversized files show an error for that file and the loop continues with later selected files. The current accepted image extensions are described as JPG, PNG, and WebP, while actual validation accepts any browser-provided image/* MIME type.
- Uploads write to the product-media storage bucket under tenant/product/timestamp-index, then insert a product_images row with public URL and sort order. A storage failure is reported and skipped. The following database insert result is not checked, so a file can upload without a gallery row. Media uploaded is a batch-level toast, not proof every selected file succeeded.
- When the gallery was empty at the start, the first selected file is marked Primary. Because the whole batch uses the original images array, only batch index zero gets that flag. Reopen/refetch and confirm exactly one intended primary.
- Hover a nonprimary card and choose the Star to make it Primary. CentriPOS first clears Primary on every product image, then sets the chosen row. Neither update result is checked and the two writes are not atomic; a failure can leave no primary or the wrong primary. Verify the badge and downstream surface before leaving.
- Drag a media card onto another card and release to reorder. The editor updates changed sort_order rows one by one. Returned update errors are not inspected and there is no optimistic preview retained after the query refresh; verify the final sequence. The upload area itself is not a drop target for new files.
- Hover a card and choose Trash only after identifying the exact image/video. There is no confirmation. CentriPOS first attempts to remove the storage object parsed from its URL, then deletes the product_images row. Neither result is checked; the Deleted toast can appear even if one side failed. Verify both the gallery and a fresh public/storage request through support when cleanup matters.
- Video display is inferred from the URL extension mp4, webm, mov, or avi. A video with another accepted video MIME/extension can upload but be rendered like an image because the gallery’s display test is extension-based. Test the saved video card and every intended customer/staff surface rather than assuming upload means playback support.
- In Warranty, enter a customer-readable Warranty label and select an application/pdf file. The visible input uses the browser’s PDF accept hint, but this form does not independently validate PDF contents or impose a file-size limit before upload. Use a trusted, product-only PDF with no customer or confidential vendor information.
- A selected file card says Uploads when the product is saved. The pending filename is used as the fallback warranty label when the entered label is blank. Choose the main product Save once; do not confuse media’s immediate upload with the warranty’s deferred upload.
- The main Save first writes the product base fields and relationships. It then uploads the warranty file to product-warranties under tenant/product/timestamp-safe-filename and separately updates warranty path, branded absolute attachment URL, and label on the product. If attachment update fails after storage succeeds, an orphaned file can remain. Preserve the error and product ID rather than repeatedly uploading.
- After success, reopen the product. The stored Warranty card shows the label and Open action. Open uses the branded product-warranty attachment route derived from the saved storage path; confirm it resolves through the branded CentriPOS host, downloads/opens the intended PDF, and uses the correct readable filename/label.
- Clear removes the pending file and clears the saved path/URL from form state. Choose the main Save to persist clearing an existing attachment. The current clear/save path removes the product reference but does not delete the old object from product-warranties, so request authorized storage cleanup when retention policy requires physical deletion. Changing only the Warranty label while retaining a path rebuilds the branded attachment URL on Save.
- Open Product Quick View for the exact product. Warranty appears when a label or attachment exists; Open warranty appears only with a resolvable attachment. On product label printing, hasWarranty is true for a label or stored path/URL and Warranty / AS IS resolves to the warranty label/fallback versus AS IS. Print one controlled label when this field is operationally required.
- Verify the intended primary/order in Sell, product quick view, and any enabled online/customer channel. WooCommerce Product Images are a separate pass-through whose files are hosted on WordPress; do not assume this native product-media gallery automatically proves WooCommerce order or hosting state.
- For a discrepancy, record tenant, product ID/SKU, media row ID, exact file name/type/size, storage path/public URL, primary flag, sort order, warranty path/branded URL/label, action time, and toast/error. Avoid repeating uploads or deletes until storage and database sides are reconciled.
- No screenshot is published for this guide. The approved Harbor & Hearth capture set has a real Products list but no exact open Images & Video or Warranty editor state. A list screenshot would not demonstrate these controls, so it is not substituted or fabricated.
Screen and contract reference
| Control or area | What it means |
|---|---|
| Saved product required | Native gallery media needs an existing product ID. |
| Upload media | Immediate multi-file picker upload; the displayed drop-area text is not backed by a drop handler. |
| Image limit | 2.5 MB per accepted image/* file. |
| Video limit | 50 MB per accepted video/* file. |
| Per-file continuation | Unsupported, oversized, or failed storage files are skipped while later selected files continue. |
| Media uploaded | Batch-level toast; not proof every storage upload and row insert succeeded. |
| Primary | product_images flag; first file of an initially empty batch is primary. |
| Star | Nonatomic clear-all then set-one primary operation with unchecked results. |
| Media order | Drag/release sequential sort_order updates with unchecked results. |
| Trash | Immediate storage-remove then row-delete without confirmation or checked results. |
| Extension-based video rendering | Only mp4/webm/mov/avi URLs are detected as video by this gallery. |
| Warranty label | Customer/staff-readable label and fallback attachment filename. |
| Warranty PDF | Browser-hinted application/pdf pending file uploaded during main product Save. |
| Warranty storage boundary | Storage upload followed by separate product attachment update; partial orphan is possible. |
| Open | Branded warranty attachment route for the stored product path. |
| Clear | Clears pending/stored references in form; main Save required and old storage object is not deleted. |
| Product Quick View | Shows label and Open warranty when the attachment resolves. |
| Warranty / AS IS label data | Warranty presence/label passed into supported product-label printing. |
| WooCommerce boundary | Separate WordPress-hosted image pass-through, not this native product-media gallery. |
| No public screenshot | No exact approved open media/warranty editor capture; no list substitution. |
Expected result
The exact parent product owns the intended media rows and storage objects; one verified primary and the saved sort order render correctly on supported surfaces; video type/playback is tested; warranty path, branded attachment URL, label, quick-view action, and Warranty / AS IS label data agree; and any partial storage/database upload, deletion, reordering, clearing, or orphaned object is reconciled before repeating an action.
Troubleshooting
- Confirm whether you are editing a product, variant, shared master record, or location-specific value.
- Search for an existing product, SKU, UPC, attribute, or tag before creating a duplicate.
- Preview labels, pricing, and availability in the intended location before broad publication.
CentriPOS API explorer · API Center administration