--- title: How do I properly format my Reward Letters? description: reward letters formatting --- [Skip to content](https://helpcenter.pequity.com/support/how-do-i-properly-format-my-reward-letters#main-content) English Show submenu for translations [More support](https://helpcenter.pequity.com/support/kb-tickets/new?hsLang=en) ![Logo (1)](https://helpcenter.pequity.com/hs-fs/hubfs/Logo%20(1).png?width=202&height=50&name=Logo%20(1).png) - [Pequity](https://pequity.com/) - [Platform](https://pequity.com/solutions) - [Blog](https://blog.pequity.com/) - [Login](https://pequity.app/login) - [Get a demo](https://pequity.com/contact) Open main navigation Close main navigation - [Pequity](https://pequity.com/) - [Platform](https://pequity.com/solutions) - [Blog](https://blog.pequity.com/) - [Login](https://pequity.app/login) - [Get a demo](https://pequity.com/contact) - English Show submenu for translations - [More support](https://helpcenter.pequity.com/support/kb-tickets/new) - Contact us Contact us How can we help you? - There are no suggestions because the search field is empty. 1. [Support Center](https://helpcenter.pequity.com/support?hsLang=en) 2. [Pequity Best Practices](https://helpcenter.pequity.com/support/pequity-best-practices?hsLang=en) # How do I properly format my Reward Letters? ### Reward Letter Template Formatting Guide This guide shows you how to format numbers, dates, and text in your Pequity reward letters. --- #### How to Use This Guide 1. Find the section for what you want to format (numbers, dates, text, etc.) 2. Copy the example code from the **“How to Use It”** column 3. Replace the example variable with your own variable name 4. Paste it into your reward letter template **Important:** Always use straight quotation marks (" or '), not curly quotes (" or '). --- #### Basic Template Syntax | Syntax | What It Does | Example | | --- | --- | --- | | {{ VARIABLE\_NAME }} | Shows the value of a variable | {{ EMPLOYEE\_NAME }} | | {{ VARIABLE\_NAME\|filter }} | Applies formatting to a variable | {{ SALARY\|toCurrency }} | | {% if VARIABLE %}...{% endif %} | Shows content only if variable exists | {% if INCREASE %}Your raise is {{ INCREASE }}{% endif %} | | {# Comment text #} | Adds a hidden note (won’t show in letter) | {# This is for internal use only #} | --- #### Formatting Money (Currencies) Use these filters when displaying dollar amounts like salaries, bonuses, or raises. | Filter | What It Does | How to Use It | Result | | --- | --- | --- | --- | | toCurrency | Adds $, commas, and 2 decimals | {{ SALARY\|toCurrency }} | $120,000.00 | | roundHalfUp:0\|toCurrency | Removes cents, adds $, commas | {{ SALARY\|roundHalfUp:0\|toCurrency }} | $120,000 | | currency\_format | Adds commas and 2 decimals (no $) \| \`${{ SALARY | currency\_format }}\` | $120,000.00 | ### Copy-Paste Examples for Money Current Salary: {{ CURRENT|toCurrency }} New Salary: {{ NEW|roundHalfUp:0|toCurrency }} Bonus Amount: {{ SPOT|toCurrency }} Salary Range: {{ RANGE\_LOW|toCurrency }} - {{ RANGE\_HIGH|toCurrency }} --- #### Formatting Numbers (No Dollar Signs) Use these filters when displaying shares, counts, or numbers without currency symbols. | Filter | What It Does | How to Use It | Result | | --- | --- | --- | --- | | roundHalfUp | Rounds to whole number | {{ 1234.56\|roundHalfUp }} | 1235 | | roundHalfUp:0 | Rounds to whole number | {{ 1234.56\|roundHalfUp:0 }} | 1235 | | roundHalfUp:1 | Rounds to 1 decimal | {{ 1234.56\|roundHalfUp:1 }} | 1234.6 | | roundHalfUp:2 | Rounds to 2 decimals | {{ 1234.56\|roundHalfUp:2 }} | 1234.57 | | round | Rounds to whole number | {{ 1234.56\|round }} | 1235 | | round(2) | Rounds to 2 decimals | {{ 1234.56\|round(2) }} | 1234.56 | | int | Removes decimals (no rounding) | {{ 1234.56\|int }} | 1234 | ### Copy-Paste Examples for Numbers Equity Shares: {{ REFRESH|roundHalfUp:0 }} Performance Score: {{ SCORE|roundHalfUp:1 }} Total Employees: {{ COUNT|int }} --- #### Formatting Percentages Use these filters when displaying raise percentages, bonus percentages, or any percent values. | Filter | What It Does | How to Use It | Result | | --- | --- | --- | --- | | decimalToPercent:0 | Converts 0.15 to 15 (no decimals) | {{ 0.15\|decimalToPercent:0 }}% | 15% | | decimalToPercent:1 | Converts 0.15 to 15.0 (1 decimal) | {{ 0.1534\|decimalToPercent:1 }}% | 15.3% | | decimalToPercent:2 | Converts 0.15 to 15.00 (2 decimals) | {{ 0.1534\|decimalToPercent:2 }}% | 15.34% | | percent\_format | Converts 0.125 to 12.5% | {{ 0.125\|percent\_format }} | 12.5% | ### Copy-Paste Examples for Percentages Salary Increase: {{ INCREASE\_PCT|decimalToPercent:1 }}% Bonus Percentage: {{ BONUS\_PCT|decimalToPercent:0 }}% Market Percentile: {{ PERCENTILE|decimalToPercent:0 }}th percentile --- #### Formatting Dates Use these filters to format dates in different styles. | Format Code | What It Shows | How to Use It | Result | | --- | --- | --- | --- | | "F j, Y" | Full month, day, year | {{ DATE\|date:"F j, Y" }} | July 24, 2025 | | "M j, Y" | Short month, day, year | {{ DATE\|date:"M j, Y" }} | Jul 24, 2025 | | "Y-m-d" | Year-month-day (ISO format) | {{ DATE\|date:"Y-m-d" }} | 2025-07-24 | | "m/d/Y" | Month/day/year | {{ DATE\|date:"m/d/Y" }} | 07/24/2025 | | "F Y" | Month and year only | {{ DATE\|date:"F Y" }} | July 2025 | | "Y" | Year only | {{ DATE\|date:"Y" }} | 2025 | ### Copy-Paste Examples for Dates Effective Date: {{ SALARY\_EFFECTIVE\_DATE|date:"F j, Y" }} Grant Date: {{ ISSUANCE\_DATE|date:"M j, Y" }} Review Period: {{ START\_DATE|date:"F Y" }} - {{ END\_DATE|date:"F Y" }} --- #### Formatting Text Use these filters to change how text appears (uppercase, lowercase, etc.). | Filter | What It Does | How to Use It | Result | | --- | --- | --- | --- | | upper | Makes all letters UPPERCASE | {{ "hello"\|upper }} | HELLO | | lower | Makes all letters lowercase | {{ "HELLO"\|lower }} | hello | | title | Capitalizes First Letter Of Each Word | {{ "hello world"\|title }} | Hello World | | trim | Removes extra spaces | {{ "  hello  "\|trim }} | hello | | replace("old", "new") | Replaces text | {{ "Hello World"\|replace("World", "Team") }} | Hello Team | ### Copy-Paste Examples for Text Employee Name: {{ EMPLOYEE\_NAME|title }} Job Title: {{ NEW\_TITLE|title }} Department: {{ DEPARTMENT|upper }} --- #### Showing or Hiding Content (Conditional Logic) Use these to show content only when certain information exists. ### Basic If Statement **Format:** {% if VARIABLE\_NAME %}   Content to show if variable exists {% endif %} **Example:** {% if INCREASE %}   Your salary increase is {{ INCREASE|toCurrency }} {% endif %} ### If/Else Statement **Format:** {% if VARIABLE\_NAME %}   Show this if variable exists {% else %}   Show this if variable doesn't exist {% endif %} **Example:** {% if has\_promotion %}   Congratulations on your promotion to {{ NEW\_TITLE }}! {% else %}   Your current title is {{ CURRENT\_TITLE }}. {% endif %} ### Multiple Conditions (OR) **Format:** {% if VARIABLE\_1 or VARIABLE\_2 %}   Show if either variable exists {% endif %} **Example:** {% if SPOT or ANNUAL %}   You are receiving a bonus this year. {% endif %} ### Multiple Conditions (AND) **Format:** {% if VARIABLE\_1 and VARIABLE\_2 %}   Show only if both variables exist {% endif %} **Example:** {% if INCREASE and INCREASE\_PCT %}   Increase: {{ INCREASE|toCurrency }} ({{ INCREASE\_PCT|roundHalfUp:1 }}%) {% endif %} --- #### Complete Examples You Can Copy ### Example 1: Salary Section {% if INCREASE %} \
  \Salary\   \Current Salary: {{ CURRENT|roundHalfUp:0|toCurrency }}\   \     Increase Amount: {{ INCREASE|roundHalfUp:0|toCurrency }}     {% if INCREASE\_PCT %}       ({{ INCREASE\_PCT|roundHalfUp:1 }}%)     {% endif %}   \   \New Salary: {{ NEW|roundHalfUp:0|toCurrency }}\   {% if SALARY\_EFFECTIVE\_DATE %}     \Effective {{ SALARY\_EFFECTIVE\_DATE|date:"F j, Y" }}\   {% endif %} \ {% endif %} ### Example 2: Bonus Section {% if SPOT or ANNUAL %} \
  \Bonus\   {% if SPOT %}     \Spot Bonus: {{ SPOT|toCurrency }}\   {% endif %}   {% if ANNUAL %}     \Annual Bonus: {{ ANNUAL|toCurrency }}\   {% endif %}   {% if BONUS\_EFFECTIVE\_DATE %}     \Effective {{ BONUS\_EFFECTIVE\_DATE|date:"F j, Y" }}\   {% endif %} \ {% endif %} ### Example 3: Equity Section {% if REFRESH or PROMO or SPOT\_EQUITY %} \
  \Equity\   {% if REFRESH %}     \Refresh Grant: {{ REFRESH|roundHalfUp:0 }} shares\   {% endif %}   {% if PROMO %}     \Promotion Grant: {{ PROMO|roundHalfUp:0 }} shares\   {% endif %}   {% if SPOT\_EQUITY %}     \Spot Grant: {{ SPOT\_EQUITY|roundHalfUp:0 }} shares\   {% endif %}   {% if ISSUANCE\_DATE %}     \Grant Date: {{ ISSUANCE\_DATE|date:"F j, Y" }}\   {% endif %} \ {% endif %} ### Example 4: Promotion Section {% if has\_promotion %} \
  \Promotion\   \Previous Title: {{ OLD\_TITLE }}\   \New Title: {{ NEW\_TITLE }}\   {% if PROMOTION\_EFFECTIVE\_DATE %}     \Effective {{ PROMOTION\_EFFECTIVE\_DATE|date:"F j, Y" }}\   {% endif %} \ {% endif %} ### Example 5: Personalized Greeting \
  Hi {{ EMPLOYEE\_NAME|title }}, \ \
  {% if has\_promotion %}     Congratulations on your promotion to {{ NEW\_TITLE }}!   {% endif %}   We're pleased to share your {{ EFFECTIVE\_DATE|date:"Y" }} compensation details.   {{ BODY\_TEXT }} \ \
  {{ CLOSING\_TEXT }},   {{ SIGN\_NAME }}   {{ SIGN\_TITLE }} \ --- #### Quick Tips ### ✅ Do This - Use roundHalfUp:0 for salaries (no cents needed) - Use decimalToPercent for converting 0.15 to 15% - Always check if a variable exists before showing it - Use straight quotation marks: " and ' ### ❌ Don’t Do This - Don’t mix different number formats (be consistent) - Don’t forget to check for empty values with {% if %} - Don’t use curly quotes: " and ' - Don’t display raw decimal values for percentages (0.15 instead of 15%) --- #### Common Mistakes and How to Fix Them | Problem | Wrong Way | Right Way | | --- | --- | --- | | Percentage showing as 0.15 instead of 15% | {{ INCREASE\_PCT }}% | {{ INCREASE\_PCT\|decimalToPercent:0 }}% | | Missing dollar sign | {{ SALARY }} | {{ SALARY\|toCurrency }} | | Too many decimal places | {{ SALARY\|toCurrency }} | {{ SALARY\|roundHalfUp:0\|toCurrency }} | | Date format wrong | {{ DATE }} | {{ DATE\|date:"F j, Y" }} | | Content shows even when empty | Bonus: {{ BONUS }} | {% if BONUS %}Bonus: {{ BONUS }}{% endif %} | | Using curly quotes (causes errors) | {{ DATE\|date:"Y" }} | {{ DATE\|date:"Y" }} | --- #### Need Help? - **Jinja2 Documentation**: https://jinja.palletsprojects.com/ - **Pequity Help Center**: https://helpcenter.pequity.com/ - **Support**: Contact your Pequity administrator --- *Last Updated: December 17, 2025* - [Getting Started with Pequity](https://helpcenter.pequity.com/support/getting-started-with-pequity?hsLang=en#main-content) - [Pequity Setup & Company Admin Onboarding](https://helpcenter.pequity.com/support/getting-started-with-pequity?hsLang=en#pequity-setup-company-admin-onboarding) - [Personal Settings](https://helpcenter.pequity.com/support/getting-started-with-pequity?hsLang=en#personal-settings) - [Integrations & Data Management](https://helpcenter.pequity.com/support/getting-started-with-pequity?hsLang=en#integrations-data-management) - [ADP Lyric HCM Integrated Pequity](https://helpcenter.pequity.com/support/adp-lyric-hcm-integrated-pequity?hsLang=en) - [Managing Your Team in Pequity](https://helpcenter.pequity.com/support/managing-your-team-in-pequity?hsLang=en#main-content) - [General User Access](https://helpcenter.pequity.com/support/managing-your-team-in-pequity?hsLang=en#general-user-access) - [Single Sign-On (SSO) Integration](https://helpcenter.pequity.com/support/managing-your-team-in-pequity?hsLang=en#single-sign-on-sso-integration) - [People Manager Access](https://helpcenter.pequity.com/support/managing-your-team-in-pequity?hsLang=en#people-manager-access) - [Pequity Features & Workflows](https://helpcenter.pequity.com/support/pequity-features-workflows?hsLang=en#main-content) - [Pequity Comp Cycles](https://helpcenter.pequity.com/support/pequity-features-workflows?hsLang=en#pequity-comp-cycles) - [Pequity Ranges Tool](https://helpcenter.pequity.com/support/pequity-features-workflows?hsLang=en#pequity-ranges-tool) - [Pequity People Tool](https://helpcenter.pequity.com/support/pequity-features-workflows?hsLang=en#pequity-people-tool) - [Pequity Approvals Tool](https://helpcenter.pequity.com/support/pequity-features-workflows?hsLang=en#pequity-approvals-tool) - [Pequity Best Practices](https://helpcenter.pequity.com/support/pequity-best-practices?hsLang=en) - [Security & Compliance in Pequity](https://helpcenter.pequity.com/support/security-compliance-in-pequity?hsLang=en) - [Proactive Support & Troubleshooting](https://helpcenter.pequity.com/support/proactive-support-troubleshooting?hsLang=en) - [Pequity Updates & Insights](https://helpcenter.pequity.com/support/pequity-updates-insights?hsLang=en) - [Pequity University](https://helpcenter.pequity.com/support/pequity-university?hsLang=en#main-content) - [Comp 101](https://helpcenter.pequity.com/support/pequity-university?hsLang=en#comp-101) - [Reward Letters](https://helpcenter.pequity.com/support/reward-letters?hsLang=en) [![Pequity](https://helpcenter.pequity.com/hubfs/Pequity%20an%20adp%20company%20final%5B96%5D%20(1).svg "Pequity")](http://pequity.com) 1 ADP Boulevard Roseland, NJ 07068 Copyright © 2026 Pequity, an ADP Company