Reusable Template Components with Snippets and Partials

Last updated May 13, 2026

PDFMonkey gives you two ways to reuse code and avoid duplication:

  • Snippets are shared across templates — define them once on the Snippets page and include them in any template.
  • Partials are local to a single template — define a reusable block inline and include it multiple times in the same template.

Both use the include tag to render the reusable block with the variables you pass.

Snippets #

If you need to share code between Templates, you can define snippets in the Snippets page of your PDFMonkey account. The name you give a Snippet is how you will refer to it later on in your Templates.

Let’s define two snippets:

{%- if userName -%}
  {{userName}}
{%- else -%}
  Someone
{%- endif -%}

{%- for item in list -%}
  <p>{{item}}</p>
{%- endfor -%}

You can then load and include them in a Template:

{%- load_snippets 'user-name', 'items-list' -%}

<p>Hello {% include 'user-name', userName: "Jane Doe" %}</p>

{% include 'items-list', list: user.groceries %}
You must load snippets with load_snippets before you can include them. List all the snippets you need in a single load_snippets call at the top of your template.

Partials #

Partials work like Snippets but are defined directly within a Template. You don’t need to load them before including them:

{%- partial 'line-item' -%}
  <tr>
    <td>{{product.name}}</td>
    <td>{{product.unitPrice}}</td>
    <td>{{product.quantity}}</td>
    <td>{{product.totalPrice}}</td>
  </tr>
{%- endpartial -%}

{% for lineItem in lineItems %}
  {% include 'line-item', product: lineItem %}
{% endfor %}

Partials are ideal when you need to repeat a block within a single template — like a table row, a card layout, or any recurring element — without the overhead of creating a shared Snippet.

Frequently asked questions

How do I reuse code across multiple PDFMonkey templates?
Use Snippets. Define reusable code blocks on the Snippets page of your PDFMonkey account, then load them in any template with the load_snippets tag and include them with the include tag.
What is the difference between Snippets and Partials in PDFMonkey?
Snippets are shared across templates — define them once and include them in any template. Partials are local to a single template — define a reusable block inline and include it multiple times within the same template.
How do I pass variables to a Snippet or Partial in PDFMonkey?
Pass variables as key-value pairs in the include tag. For example: {% include ‘user-name’, userName: “Jane Doe” %}. The Snippet or Partial can then use those variables in its Liquid code.
Navigation