Help
Log in

Printed receipt visual editor for your Shopify POS

You can use the receipt visual editor to customize the printed receipts that you issue from Shopify POS. Your store starts with a default receipt template, which is the shared template used by all POS locations unless a location has its own custom version. You can edit the default template to keep receipts consistent across locations, or customize an individual location's template, such as to display a signature line on receipts from that location only. The editor includes default content such as a return policy and a thank-you message.

The editor has built-in settings that include toggles, text fields, and image uploads that let you customize your receipts without writing code. For advanced customizations, you can add custom Liquid blocks to the header and footer. Liquid is Shopify's templating language, typically used by developers to add dynamic content, such as a custom message that changes based on the location.

The receipt code editor isn't available for POS locations in Italy or France. Refer to considerations for using the receipt visual editor for the compliance and regional requirements that apply to receipt customization.

On this page

Your printed receipt logo defaults to the logo set in your brand settings. The logo is converted to greyscale and resized for the receipt format. You can replace or remove the logo at any time.

If you want to use a different image for your printed receipts than for your brand, then you can upload a JPEG or PNG file directly in the receipt editor. For best results, use an image that is 400 px by 200 px.

Steps:

  1. From your Shopify admin, go to Sales channels > Point of Sale.

  2. In the Customize the in-store experience section, click Edit for Receipts.

  3. Optional: Select the location that you want to customize your printed receipts for.

  4. Click Header.

  5. In the Logo section, click Add image to upload a 400 px by 200 px logo image file.

  6. Optional: Use the Fullwidth logo setting to adjust whether the logo goes across the width of the receipt.

  7. Click Save.

You can add, remove, and reorder text blocks in the header and footer of your printed receipts. Text blocks allow you to type content into the header or footer without the use of Liquid code. You can add multiple text blocks and custom Liquid blocks to either section.

Header and footer changes apply to all printed receipt types (sale, return and exchange, gift, and gift card) so that your branding stays consistent across all receipts.

You can save your customizations to all locations or to a specific location when you use the Shopify admin. Changes apply to sales receipts, gift receipts, and return and exchange receipts.

Add a custom text block

You can add a text block to display fixed content, such as a promotional message or your store hours.

Steps:

  1. From your Shopify admin, go to Sales channels > Point of Sale.

  2. In the Customize the in-store experience section, click Edit for Receipts.

  3. Optional: Select the location that you want to customize your printed receipts for.

  4. To add a custom text block to your header, do the following actions:

    1. In the Header section, click ⊕ Add block > Custom text.
    2. In the Text field, enter your custom text.

  5. To add a custom text block to your footer, do the following actions:

    1. In the Footer section, click ⊕ Add block > Custom text.
    2. In the Text field, enter your custom text.

  6. Click Save.

Add a custom Liquid block

You can add a custom Liquid block to display dynamic content, such as order details or metafields. Review the variables and objects available in custom Liquid blocks before you start.

Steps:

  1. From your Shopify admin, go to Sales channels > Point of Sale.

  2. In the Customize the in-store experience section, click Edit for Receipts.

  3. Optional: Select the location that you want to customize your printed receipts for.

  4. To add a custom Liquid block to your header, do the following actions:

    1. In the Header section, click ⊕ Add block > Custom Liquid.
    2. In the Liquid code field, enter your Liquid code.

  5. To add a custom Liquid block to your footer, do the following actions:

    1. In the Footer section, click ⊕ Add block > Custom Liquid.
    2. In the Liquid code field, enter your Liquid code.

  6. Click Save.

Reorder blocks

You can reorder blocks on your printed receipt templates using the POS editor.

  1. From your Shopify admin, go to Sales channels > Point of Sale.

  2. In the Customize the in-store experience section, click Edit for Receipts.

  3. In the Header or Footer section, click a block to drag and drop it to the appropriate location.

  4. Click Save.

Receipt customization by location

By default, changes you make in the receipt visual editor apply to all POS locations. This ensures receipts are consistent across your business and reduces the number of templates you need to manage.

Considerations for receipt customization by location

Before you customize your receipts by location, review the following considerations:

  • After you customize a location's template, that location keeps its own template. Changes that you make to the default template afterward don't apply to it. For example, if you add a QR code to the default template, then the QR code isn't added to any location that you have already customized.
  • Locations that you haven't customized continue to follow the default template. This includes locations that display different content to meet local requirements.
  • To apply the default template to a location again, reset that location's template. Resetting removes the customizations for that location and can't be undone.

Location-specific content

Some receipt content is automatically location-specific and doesn't need to be set in the visual editor:

  • Store address and phone number
  • Transaction location, staff, and device details in the footer

These fields are automatically pulled from each location's settings.

Overriding content for a specific location

If you want a field, such as your return policy or a custom text block, to be different at one location, then you can override it for that location.

Steps:

  1. From your Shopify admin, go to Sales channels > Point of Sale.

  2. In the Customize the in-store experience section, click Edit for Receipts.

  3. From the location picker, select the location that you want to customize.

  4. Edit the field that you want to override for that location.

The override only applies to the selected location. All other locations use the default value.

Resetting a location template

You can reset a location-specific template back to the default value.

Steps:

  1. From your Shopify admin, go to Sales channels > Point of Sale.

  2. In the Customize the in-store experience section, click Edit for Receipts.

  3. From the location picker, select the location template that you want to reset.

  4. Click Reset to default.

Preview your printed receipts

You can preview the printed receipt from the visual editor.

You can also preview your receipt template on the Star Micronics/Epson TM (80 mm) printer or on the Star Micronics mPOP™ (57 mm) printer.

If any of your active POS devices runs a Shopify POS app version earlier than 11.10, then the receipt type drop-down menu also lists the receipt types for the previous template. Use them to review what those devices print before you update them.

Steps:

  1. From your Shopify admin, go to Sales channels > Point of Sale.

  2. In the Customize the in-store experience section, click Edit for Receipts.

  3. Optional: Select the location that you want to preview your printed receipts for.

  4. In the preview pane, use the receipt type drop-down menu to select the type of receipt that you want to preview, such as sales receipt, gift receipt, or returns and exchanges receipt.

  5. In the Preview options menu, select the printer type that you want to preview.

If you want to print a test receipt, then make sure you have a receipt printer connected to Shopify POS, and then print a test receipt.