CentriPOS builds the receipt or label HTML and initiates printing, but the browser/native shell, operating system, driver, printer, and loaded media control the final physical output. Repeated Print actions can create duplicate paper, label override barcodes, or customer documents without fixing the original layer. Stop after one failed attempt, identify the boundary, and test with safe data.
Step by step
- Reopen the exact source record. For a receipt, verify sale/receipt number, customer-safe identity, location/register, line items, quantities, totals, payment state, fulfillment, policies, and signature evidence. For a product label, verify saved product, selected variant/SKU, barcode, prices, warranty, and store branding. For a sold-item label, verify the receipt and exclude returned lines.
- Confirm the printer itself before changing CentriPOS: it is powered on, online, not paused, has the intended roll/sheet/labels loaded in the correct orientation, has no jam, and is selected on the device. A successful printer self-test with wrong CentriPOS output points back to template/media settings; a failed self-test is outside the app.
- For receipts, open Print receipt and wait for Loading receipt templates and storefront print settings to finish. If Could not load receipt templates appears, record that exact message and retry the context load after confirming network access. If No receipt templates were found for this storefront yet appears, an administrator must create/activate the required template before printing.
- Choose Print style. Sales receipt uses the selected standard template. Gift receipt hides prices. Delivery sheet produces a fuller fulfillment-oriented page and does not offer the thermal/letter selector in this dialog. Confirm that the chosen document is appropriate before exposing it to a customer or fulfillment team.
- For Sales receipt or Gift receipt, choose Paper size: Template default, Thermal receipt, or 8.5 x 11 paper. Template default follows the selected template’s thermal versus a4_letter style. Selecting another option changes the generated page style but cannot change the physical roll or driver paper configured in the system dialog.
- Choose Store policies: Storefront uses the tenant/storefront terms, Register uses the policy assigned to the original printing register, and None omits policy content. Verify the original register when historical receipts are printed from another workstation; the currently selected register is not automatically the policy source.
- For a Sales receipt, search templates by template name, type, or assigned register. Read each template’s description and assignment count. Assigned register template identifies the template configured for the original register. Template selection is disabled for Gift receipt and Delivery sheet; those styles should not be described as using an arbitrary standard-template choice.
- Read the signature note. When the sale required a signature, the output includes the saved signature when one exists or a blank signature line when it was required but not captured digitally. Confirm the signer belongs to this receipt; do not print another customer’s signature while troubleshooting.
- Choose Print receipt once. In the native iOS shell, CentriPOS can hand HTML to the native print bridge. In a normal browser it prints from a generated frame and may expose print controls if automatic handoff cannot proceed. If the app reports Could not open the print window, allow the pos.getcentri.com print/popup action and retry once after confirming no hidden print dialog is already open.
- On an iPad/iPhone user agent, Star PassPRNT is a separate button. It hands encoded receipt HTML to the starpassprnt URL scheme and requires the compatible PassPRNT app/printer workflow. If it does not open, confirm PassPRNT is installed/configured; the normal Print receipt route remains a different system/native destination.
- In the operating-system print dialog, choose the exact physical printer and paper/label size. Start with 100% or Actual size, default orientation, and no extra headers/footers when the tested template does not call for them. Browser Fit to page, unexpected margins, driver scaling, or Letter selected for a thermal roll can clip, shrink, rotate, or paginate otherwise correct HTML.
- For a product price label, first save the product. Open its Labeling/Shipping print panel, choose the saved label template or Built-in price label when no tenant templates exist, then choose Product label, All SKUs, or one exact variant SKU. Enter the number of copies; blank or invalid quantity normalizes to one.
- Treat One-off sale price, Compare at, and Print callout as print-time overrides. When any override is used, CentriPOS creates a unique label-scan override barcode for each printed copy before opening the print surface. If barcode creation fails, no label window opens. Do not repeatedly click Print because that can create additional override records with different codes.
- Check product-label data before printing: product/brand, custom fields, variant attributes, SKU, barcode/product code, regular/sale/compare-at price, callout, supplier code, warranty or AS IS state, store name/logo, and the template’s exact width, height, orientation, margins, and element bindings. A missing source value is a data/template issue, not a printer-driver issue.
- For Print sale labels from a receipt, select only non-return receipt lines that need tags, set each label quantity, and add optional print-time remarks. The built-in sold-label output includes customer, receipt, item, amount due, fulfillment/current date, SKU/barcode, notes, and a label counter based only on selected printed labels. No selected lines produces Select at least one receipt item to print.
- Choose Print once. Product and sale labels use the native iOS print bridge when available; otherwise CentriPOS writes a hidden print frame at the template’s physical inch dimensions, waits for fonts/images/barcodes to be ready, focuses it, and calls the system print dialog. A false start reports Could not open the print window; it does not prove the printer received a job.
- Print one receipt or one label as the calibration test. Inspect merchant/customer privacy, correct record, page count, clipping, rotation, margins, font fit, logo/images, price visibility, policies, signature block, notes, and counter. For a label, scan the printed code back into the intended safe product workflow and verify it resolves to the correct product/variant and override price/callout.
- If the job reaches the queue but nothing prints, inspect system queue status, printer connection, driver, media sensor/calibration, and device permissions. If the wrong printer receives it, change Destination in the system dialog rather than editing CentriPOS templates. If the queue never receives a job, inspect the native/browser handoff and console-safe error—not the printer mechanics.
- If layout is wrong on every printer, verify the CentriPOS template style/dimensions, selected paper override, and source content. If only one printer is wrong, verify that device’s driver paper, scaling, margins, orientation, density, and calibration. If only one record is wrong, compare its sale/product data, signature, policies, images, barcode, and variant fields.
- Continue a batch only after the single test is correct. Record the working CentriPOS template/style/policy, device and OS/browser, destination printer, driver paper size, scale, margins, orientation, and physical media. When contacting support, provide those settings and a redacted output photo—never full customer details, signatures, payment credentials, or reusable public links.
Screen and contract reference
| Control or area | What it means |
|---|---|
| Source record | Receipt, product/variant, or sale-line data used to construct the printable document. |
| Loading receipt templates and storefront print settings | Context query is still resolving; wait before choosing a template. |
| No receipt templates were found | Completed empty state requiring template configuration, not repeated printing. |
| Print style | Sales receipt, price-hiding Gift receipt, or Delivery sheet. |
| Paper size | Template default, Thermal receipt, or 8.5 x 11 for non-delivery receipt styles. |
| Template default | Uses the selected template’s thermal or a4_letter default. |
| Storefront / Register / None policies | Storewide terms, original-register terms, or omitted policy content. |
| Receipt template search | Search by template name, type, or assigned register for the standard receipt style. |
| Assigned register template | Template ID configured on the original receipt register. |
| Signature output | Saved signature when present or blank line when required but not digitally captured. |
| Print receipt | Native iOS bridge or generated browser-frame print initiation; not proof of physical output. |
| Star PassPRNT | iOS-only separate starpassprnt scheme handoff requiring a compatible installed workflow. |
| System Destination | Physical or virtual printer chosen outside CentriPOS. |
| Driver paper size | System/driver media definition that must match the generated template and loaded stock. |
| Scale / margins / orientation / headers | System settings that can distort or add content to a correct template. |
| Built-in price label | Fallback product label when no saved tenant label template exists. |
| Product label / All SKUs / SKU | Product-label target selection. |
| Label quantity | Copies per selected product/SKU; blank or invalid becomes one. |
| One-off sale price / Compare at / Print callout | Print-time label overrides that cause unique scan-override barcodes to be created per copy. |
| Label template dimensions | Physical width/height, orientation, margin, background, and bound elements used by the hidden print frame. |
| Print sale labels | Receipt-level sold-tag workflow that excludes returned lines and requires explicit line selection. |
| Selected label counter | Counts only copies of selected receipt lines. |
| Hidden label print frame | Browser print surface sized in physical inches and delayed until fonts/images/barcodes are ready. |
| Native iOS print bridge | Company shell callback used for receipt/label HTML when available. |
| Print queue | Operating-system evidence that the handoff reached a printer destination. |
| Calibration test | One controlled output used to prove content, scan behavior, and physical layout before a batch. |
| No substituted screenshot | The approved Harbor & Hearth capture is the Receipt Templates admin screen, not a receipt print dialog or label workflow, so this troubleshooting guide intentionally uses no mismatched image. |
Expected result
The selected printer produces one readable receipt or label at the intended size using the correct template and current record data.
Troubleshooting
- Capture the exact screen, time, expected result, and smallest repeatable steps.
- Remove unnecessary customer and payment information from screenshots.
- Include only safe receipt, order, or record references when contacting support.
CentriPOS API explorer · API Center administration