Skip to main content

Allow Beneficiary Details to Be Entered on Web Widgets

Use this guide to enable supporters to enter beneficiary details—such as the name and address of someone receiving a gift—when completing a donation through Donorfy Web Widget.

Cristina Gruita avatar
Written by Cristina Gruita
Updated yesterday

This is useful for schemes like gift memberships, tribute donations, or sponsorships where the donor and beneficiary are different people.
How Beneficiary Details Work

You can add additional HTML fields to a Web Widget so supporters can enter details about a beneficiary. When the form is submitted:

  • Donorfy searches for an existing constituent using the beneficiary email address.

  • If no match is found, Donorfy creates a new constituent as the beneficiary.

  • The beneficiary is linked to the Transaction or Recurring Payment Instruction.

  • A connection is created between the donor (main constituent) and the beneficiary.

📌Note:
All beneficiary fields must use the correct IDs and must be placed inside the <form> tag.


Beneficiary Fields and Required IDs

Use the following IDs when adding input fields to the widget:

Field

HTML Input ID

Title

AdditionalTitle

First Name

AdditionalFirstName

Last Name

AdditionalLastName

Address Line 1

AdditionalAddress1

Address Line 2

AdditionalAddress2

Town / City

AdditionalTown

County

AdditionalCounty

Postcode

AdditionalPostcode

Country

AdditionalCountry

Message / Comments

Comment

Phone

AdditionalPhone

Email

AdditionalEmail


Sample HTML for Beneficiary Details

Use or adapt the sample below to add a beneficiary section to your existing Web Widget:

<h3>Beneficiary Details</h3> <table><tbody>  <tr><td> <label for="Comment">Message</label> <input type="text" name="Comment" id="Comment" maxlength="100"> </td></tr>  <tr><td> <label for="AdditionalTitle">Title</label> <input type="text" name="AdditionalTitle" id="AdditionalTitle" maxlength="50"> </td></tr>  <tr><td> <label for="AdditionalFirstName">First Name</label> <input type="text" name="AdditionalFirstName" id="AdditionalFirstName" maxlength="50"> </td></tr>  <tr><td> <label for="AdditionalLastName">Last Name</label> <input type="text" name="AdditionalLastName" id="AdditionalLastName" maxlength="50"> </td></tr>  <tr><td> <label for="AdditionalAddress1">Address</label> <input type="text" name="AdditionalAddress1" id="AdditionalAddress1" maxlength="50"> </td></tr>  <tr><td> <input type="text" name="AdditionalAddress2" id="AdditionalAddress2" maxlength="50"> </td></tr>  <tr><td> <label for="AdditionalTown">City</label> <input type="text" name="AdditionalTown" id="AdditionalTown" maxlength="50"> </td></tr>  <tr><td> <label for="AdditionalCounty">County</label> <input type="text" name="AdditionalCounty" id="AdditionalCounty" maxlength="50"> </td></tr>  <tr><td> <label for="AdditionalPostcode">Postcode</label> <input type="text" name="AdditionalPostcode" id="AdditionalPostcode" maxlength="10"> </td></tr>  <tr><td> <label for="AdditionalPhone">Phone</label> <input type="text" name="AdditionalPhone" id="AdditionalPhone" maxlength="50"> </td></tr>  <tr><td> <label for="AdditionalEmail">Email</label> <input type="email" name="AdditionalEmail" id="AdditionalEmail" maxlength="100"> </td></tr>  </tbody></table>

⚠️Important:
Web Widgets are a Professional only feature. Essential subscribers, please contact us to find out more about upgrading.

Did this answer your question?