---
title: Admin print action
description: >-
  The admin print action component specifies a URL for print operations in admin
  print action extensions. Use admin print action to define the print target
  when merchants trigger print actions from the Shopify admin, enabling custom
  print views optimized for physical or PDF printing.
api_version: 2026-01
api_name: admin-extensions
source_url:
  html: >-
    https://shopify.dev/docs/api/admin-extensions/latest/web-components/settings-and-templates/admin-print-action
  md: >-
    https://shopify.dev/docs/api/admin-extensions/latest/web-components/settings-and-templates/admin-print-action.md
---

# Admin print action

**Requires the \[Print Action Extension API]\(/docs/api/admin-extensions/2026-01/target-apis/core-apis/print-action-extension-api).:**

The admin print action component specifies a URL for print operations in admin print action extensions. Use admin print action to define the print target when merchants trigger print actions from the Shopify admin, enabling custom print views optimized for physical or PDF printing.

Learn how to [build an admin print action extension](https://shopify.dev/docs/apps/build/admin/actions-blocks/build-admin-print-action).

### Support Targets (4)

### Supported targets

* [admin.​order-details.​print-action.​render](https://shopify.dev/docs/api/admin-extensions/2026-01/targets/orders#order-details-print-action-)
* [admin.​order-index.​selection-print-action.​render](https://shopify.dev/docs/api/admin-extensions/2026-01/targets/orders#order-index-selection-print-action-)
* [admin.​product-details.​print-action.​render](https://shopify.dev/docs/api/admin-extensions/2026-01/targets/products#product-details-print-action-)
* [admin.​product-index.​selection-print-action.​render](https://shopify.dev/docs/api/admin-extensions/2026-01/targets/products#product-index-selection-print-action-)

#### Use cases

* **Print document wrapper:** Wrap your print extension UI to create print action extensions.
* **Custom printables:** Build interfaces for generating custom printable documents.
* **Document configuration:** Create UIs for configuring print options before generation.
* **Print workflows:** Implement workflows for selecting and customizing printed materials.

***

## Properties

Configure the following properties on the admin print action component.

* **src**

  **string**

  The URL of the document to preview and print. Supports HTML, PDF, and image formats. If not provided, the preview will show an empty state and the print button will be disabled.

***

## Examples

### Set a print source URL

Set the print source URL for an admin print action extension. This example shows the component pointing to an external URL for printing.

## Set a print source URL

![Set the print source URL for an admin print action extension. This example shows the component pointing to an external URL for printing.](https://shopify.dev/assets/assets/images/templated-apis-screenshots/admin/components/adminprintaction-example-33iuhoCB.png)

## html

```html
<s-admin-print-action src="https://example.com/orders/12345/packing-slip"></s-admin-print-action>
```

### Print a PDF document

Point directly to a PDF file for printing invoices or receipts. This example sets the `src` to a PDF URL that the browser renders in the print preview.

## html

```html
<s-admin-print-action src="https://example.com/orders/12345/invoice.pdf"></s-admin-print-action>
```

### Use a dynamic print URL

Build the print URL with query parameters to customize the output per order or template. This example passes order ID, template name, and locale as URL parameters.

## html

```html
<s-admin-print-action src="https://example.com/print?order=1042&template=packing-slip&locale=en"></s-admin-print-action>
```

***

## Best practices

* **Use print-optimized URLs:** The URL should point to a page specifically designed for printing with print CSS stylesheets that hide navigation, adjust colors for readability, and set appropriate page dimensions.
* **Test across print scenarios:** Verify output when printing to PDF, physical printers, and different paper sizes. Test with both color and black-and-white settings.
* **Handle dynamic content:** If the print URL includes order-specific or time-sensitive data, ensure it's properly encoded in the URL parameters and accessible at print time.
* **Validate URL accessibility:** Ensure the print URL is accessible to merchants. Check authentication requirements and that the page loads successfully before printing.

***

## Limitations

* Only HTML, PDFs, and common web image formats (JPEG, PNG, GIF, WebP) are supported for the print source URL.
* If the `src` property isn't provided, the preview will show an empty state and the print button will be disabled.

***