(Public) - How to update the Alma Letters to make them ADA Accessible

How to update the Alma Letters to make them ADA Accessible

Customizing Alma Email Templates for Your Institution

You can modify the UW-Madison Library Alma email templates to fit your institution by following these steps.
 
  1. Get the Email Templates
    All templates are available in this GitHub repository: https://github.com/UW-Madison-Library/alma-emails
    You can either: 
    1. Clone the repository (git clone https://github.com/UW-Madison-Library/alma-emails.git)
    2. Download individual email templates as needed
  2. Modify the Main Stylesheet (style.xsl)
    Most customization is done in components/style.xsl, which controls the email structure and styles. 
    1. Change Colors (Links, Text, etc.) 
      1. Locate the <xsl:template name="libraryStyle">section.
      2. Modify the CSS in this template to update link colors, text colors, and other styles.
    2. Update Your Institution’s Logo
      1. Locate the <xsl:template name="libraryLogo">section.
      2. Modify the first <a href=""> link to point to your institution’s website. 
        1. Do not remove this first <a href=""> tag (even though it is hidden with display: none). Removing it will prevent emails from sending.
        2. If Using Your Institution's Alma Logo, remove display: none; from this section
          <tr style="display: none;" aria-hidden="true">
             <td>
                 <a href="https://www.library.wisc.edu/" style="color: #0073CE;" target="_blank">
                     <img src="cid:logo.jpg" alt="University of Wisconsin-Madison Libraries Logo" width="auto" height="20"/>
                 </a>
             </td>
          </tr>
      3. Modify the SECOND <a href=""> link to point to your institution’s website. 
        1. If you are using the logo uploaded into Alma, this table row can be deleted
        2. Otherwise, if you are going to host your logo somewhere other than in Alma, Modify the section below to point to your institution’s hosted logo. Important Note: ensure that the email sending domain matches the logo’s domain to avoid image display issues in email clients.
          <tr>
             <td class="darkmode" align="center" valign="top" style="background-color: #333333; background: linear-gradient(#333333,#333333);">
                 <table border="0" cellpadding="0" cellspacing="0" role="presentation">
                     <tr>
                         <td align="center" valign="top" style="padding: 20px 0;">
                             <a href="https://www.library.wisc.edu/" style="color: #0073CE;" target="_blank">
                                 <img src="https://web.lib.wisc.edu/a/images/libraries-inverted-vertical@2x.png" width="200" height="134" alt="University of Wisconsin-Madison Libraries" style="border: 0;"/>
                             </a>
                         </td>
                     </tr>
                 </table>
             </td>
          </tr>
    3. Update Signature & Contact Information
      Modify these sections to include your institution's signature and contact details: 
      1. <xsl:template name="circulationSignature">
        <xsl:template name="ILLSignature">
        <xsl:template name="AdminSignature">
    4. Customize the Email Footer - Locate <xsl:template name="libraryFooter"> Update this section as needed for your institution.
  3. Review and Modify Individual Email Templates
    Inside the letters/ folder, you’ll find: 
    1. Subfolders for each Alma letter 
      1. Each folder contains: 
        1. XML and XSL files defining the letter’s content and structure
        2. Markdown (.md) files with descriptions of each letter’s purpose, subject line, and title
        3. Note: The letter subject and title are set within Alma’s interface. The .md files serve as documentation.
    2. If further adjustments are needed, check each letter’s XSL file for additional styles. This step is not required unless deeper customization is needed.


Keywords:
Accessibility, Alma, Letters, editing letters
Doc ID:
147348
Owned by:
Katie S. in UWLSS
Created:
2025-01-08
Updated:
2025-03-25
Sites:
UW Libraries Shared Systems, UW-Madison Libraries