# Shortcodes, blocks and hooks

> Place the button and the quote list anywhere, override templates in your theme and hook into every step.

- Source: https://plugstack.dev/docs/qtyra-quote-requests-catalog-mode/developer-reference/
- Published by: PlugStack
- Last updated: 2026-10-22

## Shortcodes

 
 

| Shortcode | What it shows |
| --- | --- |
| `[qtyra_button]` | The Request a Quote button for the current product. Attributes: `id` (a product ID, for use outside product pages), `text`, `class`, `wrapper_class`. |
| `[qtyra_quote_list]` | The customer’s quote list with the request form. The *Request a Quote* page uses it. |

 
 

```
[qtyra_button id="123" text="Ask for a price"]
```

 

## Blocks

 

In the block editor, search for **Quote Button** and **Quote List**. They work in posts, pages and block theme templates.

 

## Template overrides

 

Copy a file from the plugin’s `templates/` folder to `your-theme/woocommerce/qtyra/` and edit the copy. Your version is used instead and survives plugin updates.

 
 

| Template | Used for |
| --- | --- |
| `quote-button.php` | The button. |
| `quote-modal.php` | The popup. |
| `quote-form.php` | The request form. |
| `quote-list.php`, `quote-list-empty.php` | The quote list page. |
| `quote-view.php` | The customer’s private quote page with the offer. |
| `emails/*.php`, `emails/plain/*.php` | The three emails, HTML and plain text. |

 
 

## Actions

 
 

| Action | Fires when |
| --- | --- |
| `qtyra_quote_submitted`, `qtyra_quote_created` | A request is sent and saved. |
| `qtyra_quote_status_changed` | A quote changes status. |
| `qtyra_quote_send_offer` | You send an offer. |
| `qtyra_order_created_from_quote` | An order is created from a quote. |
| `qtyra_item_added_to_list`, `qtyra_item_removed_from_list`, `qtyra_item_qty_updated`, `qtyra_list_cleared` | The customer changes the quote list. |
| `qtyra_settings_saved` | Settings are saved. |

 
 

## Filters

 
 

| Filter | Lets you |
| --- | --- |
| `qtyra_resolved_mode` | Change the final mode of a product: `normal`, `price_hidden` or `quote_only`. |
| `qtyra_is_product_requestable` | Allow or block quote requests for a product. |
| `qtyra_form_fields` | Add, remove or reorder form fields. |
| `qtyra_customer_can_pay` | Decide whether the customer may pay an offer. |
| `qtyra_should_enqueue_assets` | Load or skip the plugin scripts on a page. |
| `qtyra_trusted_proxies` | List proxy IPs, so rate limiting sees the real visitor IP behind a load balancer. |
| `qtyra_admin_quotes_query_args`, `qtyra_admin_can_view_quote` | Change which quotes staff see in the admin. |

 
 

```
// Always ask for a quote above 1,000 in the cart currency.
add_filter( 'qtyra_resolved_mode', function ( $mode, $product ) {
	return ( $product && (float) $product->get_price() > 1000 ) ? 'quote_only' : $mode;
}, 10, 2 );
```
