# Adding New Avery Type Label Configuration

{% hint style="info" %}
**Note:** While this example is for an **Avery Label**. Any label can be configured and this guide can help you translate your label into a label configuration.
{% endhint %}

## Download the Avery Label Template

For this Guide, we will be using the ***Avery 5160 Template***.

1. Navigate to the Avery Templates page: <https://www.avery.com/templates>
2. Search for or locate the Template you wish to add. For our documentation, we are using the ***5160*** template: [https://www.avery.com/templates/5160](< https://www.avery.com/templates/5160>)
3. Download the **Microsoft Word (.doc)** version of the template

{% hint style="info" %}
**Note**: It is important to download the **Microsoft Word** version of the template.
{% endhint %}

<figure><img src="/files/yAuqph4TjZMBv0AYQFKt" alt=""><figcaption></figcaption></figure>

## Converting the Word Doc to an Avery Label Configuration

In order to make transitioning the Avery Label Template into PDF Generator we will need to manually review the Page Setup and Table Properties of the Avery Label Word Document. These steps should be generally the same for all Avery Label types.

### Preparation Steps

1. Open the Avery Label Template in Microsoft Word. Leave it open until we've completed all steps.
2. Navigate to a **New** Avery Label Config form in the PDF Generator application.

### Create Avery Label Config

1. **Name**: Easy Peel Address Labels
2. **Avery Number**:  5160
3. **First Row Padding**: 0
4. **Inbetween rows padding**: 0
5. **Max Labels per page**: 30
6. **Advanced Styling**: Checked/True

<figure><img src="/files/I0GTwziA0GyrlXhN6lf8" alt=""><figcaption><p>Initial Avery Label Values for 5160</p></figcaption></figure>

### Configure Page Margins

1. If not already, open the Avery Label Word Document

2. Open the Page Setup dialog. This can generally be done by clicking on **Layout** > **Margins** > **Custom Margins**

3. On the Avery Label Config form, locate the **Page Settings** section and the **Margins** sub-section.&#x20;

4. Copy over the margin and Page size settings from the Page Setup dialog in Microsoft word.

   1. Page Setup Margins

      <div align="left"><figure><img src="/files/VLzwAby175XQyy3pda33" alt=""><figcaption><p>Page Margins</p></figcaption></figure></div>

   2. Page Paper Size

      <div align="left"><figure><img src="/files/hlVZKLoCQSLkuH9OR38r" alt=""><figcaption><p>Page Paper Size</p></figcaption></figure></div>

   3. Final CSS settings in the PDF Generator Avery Label Config

      <figure><img src="/files/k6scjvskyUNXUIfa0pnt" alt=""><figcaption><p>Final Page Settings</p></figcaption></figure>

5. Save the PDF Generator Avery Label Config

### Set up Label Dimensions

Next we will set up the Label Dimensions so that PDF Generator knows how to place the labels on the page.

1. If not already, open the Avery Label Template Word Document
2. If not already, open the PDF Generator Avery Label Config
3. On the PDF Generator Avery Label Config, scroll down to the **Avery Label Dimensions** related list

   <div align="left"><figure><img src="/files/c7JmloAC1NwxEr8l0sXP" alt=""><figcaption></figcaption></figure></div>
4. On the Avery Label Word Document, right click on the Table of labels, and select **Table Properties**\
   ![](/files/Ugnlr0P2RJVZudVHaMkn)
5. Click on the "Row" Tab
6. Locate the **Height** value and multiple it by 96  to get the "pixel" value we need for our Avery label dimensions. ***NOTE:** Round-Down to the nearest number.*
   1. In our case, the **Height** value will be ***96***\
      ![](/files/l2wXiVqqrIS6aaxGCjC5)
7. Click on the Column Tab
   1. Depending on where you clicked to open the "Table Properties" you may not be on the **FIRST** column. Click the Next and/or Previous column buttons until it shows you on **Column 1.**\
      ![](/files/fyXn3i2YsCyMU1QXMTDe)
8. Here we will do similar math to our height, multiplying the **Inch** value by 96 to get **Pixel** values, and then rounding down.
9. Create an "Avery Label Dimension" record for each of the columns, using the **Height** of the Row (Step 6) and the **Width** of each column (Step 7), clicking **Next Column** as we complete each one.
   1. **NOTE:**  It is critical to select "Label" or "Padding" as the **Type** in the Avery Label Dimension.
      1. You can differentiate by comparing the **Column Number** to the layout of the labels.
10. For the 5160 Label, your final Avery Label Dimension related list should look like this:

<figure><img src="/files/ZsVVRilZ1vORY2QYeOe2" alt=""><figcaption><p>Avery Label Dimension Records</p></figcaption></figure>

11. Once you have entered all of the Avery Label Dimensions, you can use the **Generate HTML** button to generate examples on the Avery Label Config and perform initial verification.

## Using Your Newly Created Label

Now that you have completed your Avery Label Configuration, you will need to create an Avery Label Template, select your new Avery Label Config, create Field Maps, and configure your template to be used / printed.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.yansalabs.com/pdf-generator/technical-docs/building-a-pdf-template/creating-labels/adding-new-avery-type-label-configuration.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
