In This Article:

    Custom Donation HTML starter

    In This Article:

      One of the questions that clients ask a lot is how to make Custom Donation HTML work for their page. Another question that we get asked a lot is "why is my custom donation HTML not working"?

      The answer to both of the questions is "We're really sorry, but Salsa doesn't support Custom Donation HTML." Which is true. However, we like to help out when we can, so here are some tips, and a starter kit.


      1. Salsa does not support donation pages with Custom Donation HTML. Custom Donation HTML contents are provided by customers and clients, and are not covered by your support agreement. However, we will do what we can to give you advice about how to make it work.
      2. Custom Donation HTML replaces all of the amount section of a donation page. That includes the amounts that you choose and whether or not recurring donations are allowed.
      3. Your Custom Donation HTML must provide some required fields in order to be effective.  The rest of the HTML (appearance, behavior, validation) is a clean slate.

      Required fields

      Your Custom Donation HTML must provide HTML fields with these names in order to submit valid donations. Please note that names are case sensitive. amount is not the same as AMOUNT.


      Name Contents
      recurring Whether or not the donation is recurring.
      • Must be zero (0) for one-time donations.
      • Must be one (1) for recurring donations.
      TERM Number of payments to collect. Use '9999' for unlimted payments.
      Required for recurring donations.
      • How often to collect the amount.
      • WEEK: weekly
      • MONT: monthly
      • QTER: quarterly
      • SMYR: semi-yearly
      • YEAR: year
      Required for recurring donations.
      amount Number of currency units (typically dollars) to donate.
      • Can have a decimal followed by two digits.
      • May not contain currency signs (like "$"), spaces or commas.
      Either amount or amountOther is required for all donations.

      An amount to use instead of "amount'. Generally not used in Custom Donation  HTML, but that's not a hard-and-fast restriction. If amountOther appears, then it overrides any amount values.

      • Can have a decimal followed by two digits.
      • May not contain currency signs (like "$"), spaces or commas.
      Either amount or amountOther is required for all donations.

      Starter kit

      The starter kit contains all of the script and fields that you'll need to make a working Custom Donation HTML field that

      • accepts donations of 10, 20 or 30 dollars
      • accepts one-time donations
      • accepts recurring donations, and
      • provides the same radio buttons for amounts as a standard Salsa donation page.

      Here are some steps that you can use to install the starter kit.

      1. Edit a donation page.
      2. Click on the "Other Text" tab.
      3. Locate the "Custom Donation HTML" field.
      4. Click here to see the page where the starter code lives.
      5. Click on the Raw button. A window will appear that contains just the starter code.
      6. Copy the contents of the window and close it.
      7. Return to the donation page editor.
      8. Paste it into the "Custom Donation HTML" field for your donation page
      9. Customize it
      10. Test, test, test!


      While Salsa does not support pages with Custom Donation HTML, we do try to suggest ideas that can be used to get pages to work. With that in mind, if you do have any questions, then please gather this information.

      • Your organization_KEY
      • Your chapter_KEY if you are in a chapter
      • The donate_page_KEY of the modified donation page. You can see this in the browser's address bar when you are editing and viewing donation pages.
      • A screenshot, if possible.

      Please send this information to, and we'll see what we can do.

      Was this article helpful?
      0 out of 0 found this helpful
      Have more questions? Submit a request



      Please sign in to leave a comment.