Add Parameters to Optimized Donation Form Hyperlinks

After you find the IDs for the designation or appeal you want to track from a donation form, add them to the Optimized Donation Form's hyperlinks that open the form from a webpage, links in emails, or buttons. To use these hyperlinks, if the Optimized Loader Script must be on your website.

Note: You can add only one designation and appeal to a URL.

  1. In Online Giving, select All donation forms under Related links.

  2. Select the form.

  3. Under Publish, select Copy from Hyperlinks, Open form on top of same webpage.

  4. Associate the form with the parameters,

    • For a designation, add &desid=ID to the end of the hyperlink. Replace "ID" with the designation's ID. For example,

      <a href="?bbFormId=22c45fbe-bef6-45c5-b345-f48671654671&desid=2">Donate</a>

      Tip: To display the designation's name on a donation form, add &desname=Name after &desid=ID. Replace "Name" with the appropriate name for the designation. For example, https://www.bb.com/donor-form?svcid=renxt&formId=8aa3b1c7-e4ad-4ee5-adff-e40efa81aae8&envid=t-Z-FEhKwLvkGVGjTCcbBMEA&zone=usa&desid=48923&desname=2023 General Fund. The designation name isn't associated with the gift, but it lets you to use donor-friendly names when your designations have a naming convention, such as 2023-GenFund. Additionally, if the name you use has spaces those are automatically replaced with %20 when you use the URL.

    • For an appeal, add &appealid=ID to the end of the hyperlink. Replace "ID" with the appeal's ID. For example,

      <a href="?bbFormId=22c45fbe-bef6-45c5-b345-f48671654671&desid=2&appealid=5">Donate</a>

  5. Paste the HTML in your content's HTML editor.

  1. In Online Giving, select All donation forms under Related links.

  2. Select the form.

  3. From All donation forms, under Related links, select the form.

  4. Under Publish, select Copy from Hyperlinks, Open form from other webpages or emails.

  5. Change https://yourwebsite.org to your organization's website.

    Note: If your hyperlink already has a question mark, use an ampersand ("&") before bbFormID.

  6. Associate the form with parameters,

    • For a designation, add &desid=ID to the end of the hyperlink. Replace "ID" with the designation's ID. For example,

      <a href="https://fresh-air.org?bbFormId=22c45fbe-bef6-45c5-b345-f48671654671&desid=2">Donate</a>

      Tip: To display the designation's name on a donation form, add &desname=Name after &desid=ID. Replace "Name" with the appropriate name for the designation. For example, https://www.bb.com/donor-form?svcid=renxt&formId=8aa3b1c7-e4ad-4ee5-adff-e40efa81aae8&envid=t-Z-FEhKwLvkGVGjTCcbBMEA&zone=usa&desid=48923&desname=2023 General Fund. The designation name isn't associated with the gift, but it lets you to use donor-friendly names when your designations have a naming convention, such as 2023-GenFund. Additionally, if the name you use has spaces those are automatically replaced with %20 when you use the URL.

    • For an appeal, add &appealid=ID to the end of the hyperlink. Replace "ID" with the appeal's ID. For example,

      <a href="https://fresh-air.org?bbFormId=22c45fbe-bef6-45c5-b345-f48671654671&desid=2&appealid=5">Donate</a>

  7. Paste the HTML in your content's HTML editor.