Settings

Prepare and Upload Kiosk Images

Kiosk Images provides separate Home Banner, Logo, Banner and Advertisement uploads for the current branch. Each selected image is previewed before Save, and only selected slots are replaced.

Menu path
Settings -> Sales Channels -> Kiosk -> Images
Verified from
Posnic demo and current POS source reviewed on 2026-09-08
Technical source evidence

Live demo Settings -> Sales Channels -> Kiosk -> Images audited 2026-09-04, frontend/modules/settings_write.html kioskimage-line four file controls, frontend/static/script/js/modules/js/settings.js handleFileChange submitKioskImages and default previews, api/src/routes/settings.routes.js updateKioskImages upload fields, api/src/middleware/upload.js MIME and 5 MB limits, api/src/models/setting.model.js updateKioskImagesModel and storedKioskImageModel, api/src/repositories/item.repository.js kiosk_images response, api/src/services/item.service.js kiosk image URL resolution

Four kiosk image slotsLive Posnic demo rechecked 2026-09-04. Each edit icon selects a file for its named slot; Save submits the newly selected files together.
Confirm the channel firstImages belong to the current branch kiosk entry. Confirm the branch and Store ID before replacing customer-facing artwork.

Understand the Four Slots

SlotOperator purposePreparation guidance
Kiosk Home BannerPrimary home or entry artwork shown by the kiosk experience.Use a clean, recognizable welcome image with important content away from the edges.
Kiosk LogoShop identity used by the customer-facing channel.Use the official shop mark with enough clear space and strong contrast.
Kiosk BannerSecondary promotional or category artwork.Use a wide composition and keep text large enough for the kiosk screen.
Kiosk AdvertisementPromotional artwork supplied with the kiosk catalog response.Use current, approved messaging and remove expired offer dates before upload.

Prepare Files Before Opening Posnic

  • Use JPEG or PNG. The current server accepts JPEG, JPG and PNG image MIME types; do not rely on the browser preview accepting a GIF or BMP filename.
  • Keep every individual file below 5 MB. A file exactly at or above the limit is rejected by the browser or upload middleware.
  • Export in the final intended aspect ratio to avoid unexpected cropping or empty space on the customer screen.
  • Compress photographs as JPEG and use PNG when a logo needs transparency or very sharp edges.
  • Check spelling, prices, dates, phone numbers and offer conditions inside artwork before publishing.
  • Name files by branch, slot and revision so another operator can identify the approved source later.

Upload or Replace Images

  1. Confirm the active branch in the Posnic header and confirm its Kiosk Store ID on the Account tab.
  2. Open Images. Existing custom images load as previews; a built-in default appears where no custom image is stored.
  3. Click the edit icon above the slot you want to replace.
  4. Choose the approved JPEG or PNG file and inspect the immediate preview.
  5. Repeat for any other slots that must change in the same update. You do not have to select all four.
  6. Click Save once and wait for Kiosk image update successfully.
  7. Reopen the Images tab and confirm every changed slot loads from its saved image rather than only the temporary local preview.

What Save Changes

  • Save does nothing when no file has been selected; changing nothing does not re-upload the previews.
  • The form can send up to one newly selected file for each of the four named slots in one request.
  • Only slots included in that request are updated. An unchanged Logo, for example, remains stored when only Advertisement is selected.
  • The images are saved in the current branch's kiosk entry and returned to kiosk catalog requests for that Store ID.
  • The current Images tab has no active delete button. Replace an unwanted image with approved artwork; do not promise operators that clicking the preview removes it.

Verify on the Customer Side

  1. Open the deployed kiosk link for the branch's Store ID in a fresh browser window or on the real kiosk device.
  2. Confirm the shop identity and all expected artwork belong to the intended branch.
  3. Check the home screen, catalog area and any promotional placement that uses Banner or Advertisement.
  4. Inspect portrait and landscape kiosk orientations used by the shop for clipping, unreadable text and stretched logos.
  5. Refresh once to make sure a cached older image is not hiding the update.
  6. Place a controlled test order only after branding, item availability, payment and print settings all belong to the same branch.

Troubleshooting

SymptomLikely causeAction
Only these file types are acceptedThe browser filename extension is outside its preview list.Export a new JPEG or PNG and select it again.
Invalid file type. Only JPEG, JPG, and PNG files are allowedThe server rejected the file MIME type even if the browser displayed a preview.Use a genuine JPEG or PNG file, not a renamed GIF, BMP or WebP.
File size should be less than 5MBThe selected file is at least 5 MB.Resize or compress it below 5 MB, then reselect it.
Preview changes but customer kiosk does notSave was not completed, the old image is cached, or the wrong Store ID is open.Wait for success, reload Images, verify Store ID and hard-refresh the customer device.
One old slot remainsOnly selected slots are replaced.Select a replacement for that exact slot and save again.
Wrong shop artwork appearsImages were saved while another branch was active or the kiosk link uses another Store ID.Stop customer use, compare branch-to-ID mapping, then upload to the correct branch.
Image looks stretched or clippedArtwork aspect ratio does not suit the deployed kiosk placement.Re-export for the tested screen and replace the affected slot.
Save appears to do nothingNo new file is selected.Choose at least one file; an existing preview alone is not submitted.

Publishing Checklist

  • Active branch and Store ID are confirmed.
  • Every source file is an approved JPEG or PNG below 5 MB.
  • Temporary previews match the intended slot before Save.
  • Saved previews survive leaving and reopening Images.
  • Fresh customer-side kiosk session shows the correct artwork without clipping.
  • A rollback copy of the previous approved artwork is retained outside Posnic.
  • The final kiosk order test covers the same branch, catalog, payment and printer configuration.

Related Manual Pages

Settings Kiosk Store ID The Kiosk Account tab stores one 3-6 character alphanumeric Store ID for the current branch. That identifier is used to resolve the branch for kiosk catalog and order requests. Settings Kiosk and Sales Channels Kiosk and sales channels let customers place or review orders away from the cashier screen. Operators configure account, images, payment and print settings, then review channel orders in Kiosk Reports. Catalog Create Item Use the full Add Item form when the product must be searchable, scannable, stocked, reported and controlled correctly. Settings Payment Gateways Payment Gateway stores merchant credentials for the current branch. Razorpay currently controls sale QR and kiosk payment availability; PhonePe has a configuration surface that must be verified against the shop's deployed checkout before rollout. Reports KOT and Kiosk Reports KOT and Kiosk reports are channel reports. They help restaurant and self-order operators separate table activity, kitchen tickets, cancellations, discounts and kiosk totals from normal counter sales.