Allowing People to Update their Permissions and Preferences


You can enable your supporters to update their contact details and preferences by themselves using the 'Self Service' widget on your website. 

The Update Preferences Widget will allow a supporter to update the following details:

  • Name
  • Address
  • Phone numbers
  • email address
  • Channels 
  • Purposes (the ones you choose to display)
  • Preferred contact method


The Update Preference Widget is a Professional-only feature. Essential subscribers, please contact us to find out more about upgrading.


How it works

  • Add the preference update widget to your website - the widget allows people to enter their email address and request a link to update their communication preferences
  • When people request a link if there is
    • One constituent with the email address entered Donorfy will then send an email with a link to the preference update form where they can update their preferences, after they complete the form their constituent record is updated in Donorfy with their preferences
    • No constituents with the email address entered Donorfy will send an email with a link, when the person requesting the link completes the preferences update form they will be added as a new constituent in Donorfy
    • More than one constituent has the email address entered then a message will be displayed asking the person to get in touch with you to update their preferences 
  • Donorfy must be linked  to your email system for this work - see this for more information

Setting the Widget up

1. Choose which Purposes to Display on the Preference Update Form

You can choose which of your purposes you want to include on the preference update form, you can also enter a description to appear on the preference update form - e.g. you may have an purpose called 'Events' - on the preference update form you might want a fuller description such as 'Information about events we run'.

To do this go into Settings and search for 'Purposes' - for each purpose you want to show on the form

  • Set 'Include this purpose on the public facing Preference Update Form' to Yes 
  • Enter a suitable description for the purpose

2. Customise the Wording used with Preference Update Widget and the Email

In Donorfy go into Settings and search for 'Preference Update Settings' - you can enter the text you would like to display on the widget and email.

3. Add the Preference Update Widget to your website

To add the preference update widget you will need to add the HTML below to a suitable page(s) on your website.

<iframe style="width: 100%; height: 150px;" width="300" height="150" frameborder="0"
src="{your api key}" ></iframe>

Note that 

  • the placeholder {your api key} must be replaced with your API key - see this for help finding your API key - e.g. if your api key was abcdefgh your link would be
  • you can adjust the styling, size etc of the widget to suit your website - i.e. make changes to style="width: 100%; height: 150px;" width="300" height="150" frameborder="0" 

4. Checking who has updated their preferences

To see the details of preference update requests you can

  • Look on the Errors & Info tab under Financial | Online Donations 
  • Create a list - see this 

The Donorfy Academy features a learning course for Constituent Preference Updates - enrol here



Please sign in to leave a comment.
Powered by Zendesk