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, the Optimized Loader Script must be on your website.

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

Tip: To save time and reduce errors, use the URL parameter builder to assemble a valid URL. This ensures the parameters are combined correctly so you don't have to manage the URL formatting rules manually.

  1. From Online Giving, Donation forms, select the form.

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

  3. 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>

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

  1. From Online Giving, Donation forms, select the form.

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

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

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

  4. 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>

    • For a package, add &packageid=ID to the end of the URL of a Standard Donation Form. Replace "ID" with the packages's ID. For example, https://www.bb.com/donor-form?svcid=renxt&formId=8aa3b1c7-e4ad-4ee5-adff-e40efa81aae8&envid=t-Z-FEhKwLvkGVGjTCcbBMEA&zone=usa&packageid=32

      Warning: When you add a package to a URL, also add the associated appeal to the URL or configure the appeal in the donation form. Otherwise, when you approve a batch you will have to fix the batch exceptions.

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