1/11/22¶

Webhooks

We're introducing a Push API that lets things happening in ActionKit trigger external programmatic processes. So when a user takes an action, we'll send details of the action and user to the web endpoint you specify. For example, you could use Zapier and Thanks.io to send donors a personalized thank-you postcard. Read more in the documentation.

Importer

• We added a "Subscribe only if new to database" option for import pages. When you upload user data using this option, data will be added or updated as usual, but only users who are completely new to your database will be subscribed to the list you provide. Thanks to Kurt working for Demand Progress and Kenneth working for ACLU People Power among others for this idea.
• If you make a mistake when importing new users and mess up their source, previously you'd have to update their source using the API. Now you can also update a user's original source in core_user with an import, using the "initial_source" column. Please be careful with this!

Reports

• The core_click table filters out fake clicks generated by some email scanning services. We added a core_click_raw table that includes all clicks, including fake ones, for a limited period (currently 90 days).
• We added new summary tables, summary_mailing and summary_mailingsubject, that include commonly-used mailing performance stats like opens, clicks, actions, donations, and unsubscribes, by mailing and subject. Right now, this table is updated nightly for the first 30 days after a mailing is sent, but we might change this schedule over time.
• We added a count of how many rows your reports return to the top of your report results. Thanks to several people, most recently Harrison at Dream Corps for the request!
• We added a link to the top of the Edit Report screen to run the saved version of a report. This helps you run reports without worrying you unintentionally saved changes to them.
  
• Using certain report parameter names collided with internal variables, causing unexpected behavior. Reports using these reserved parameter names will now show a helpful error. You may need to change some parameter names to accommodate this, e.g. replacing "zip" with "zipcode".
• Users of the background reports API should know that the "download_uri" provided for CSV and TSV downloads now redirects to an S3 URL. Most applications should work as before, but if you have trouble, make sure that your code follows redirects when downloading report results.

Admin Improvements

• We added Copy and Hide buttons to the top of most screens. Thanks to Jin at The Social Practice and Jase at 350 for reporting!
• If you are searching from the header sidebar and find only one page, mailing, etc., hitting Enter takes you directly to its edit screen, instead of to a one-item result list. Now that Copy and Hide are on edit screens as well as lists, we're hopeful that skipping the item list will almost always be what you want to do.
• We added a button to help you get previews more easily. First, target your mailing. Once it's built, click the "Random" button under the preview pane to preview for a random user in your targeting set. Thanks to Virginia at Middleseat working for Justice Democrats for inspiring this feature.
  
• Heads up: the login screen is changing! We've added links to helpful resources, blog posts, videos, and other documentation to the login screen, to help you get the most out of ActionKit.
  

Pages and templates

• We added an option to the goal thermometer on donation pages to support donations made in their original currencies, not just converted to US dollars. Thanks to Kirk at Canada's NDP for the request!
• When using the "Original Currency" goal, if you have donation pages that are part of a multilingual campaign, each page will now have its own separate goal. Thanks to Mais at the Syria Campaign for the request!
• The language picker's links now preserve akid and other URL parameters.
• If you just look at a Templateset's template code without making any changes, we will no longer show it as having "Draft" status. Thanks to Alli at MoveOn for the request.
• We added a new filter, |number, to convert number-like text to a number, which is useful when using if statements. We're using this new filter to improve how quickly many of your re-engagement queries will run.
• We've added suggestions to the docs on making existing templatesets more flexible to help avoid proliferation. Having fewer, more flexible templatesets can help you maintain a consistent look and save you maintenance work. A link to the docs on templateset management has been added to the confirmation modal for copying a templateset.
• We fixed a problem where if you pushed several templateset edits from GitHub, and one of them contained an error, we'd throw out the whole bunch instead of applying your changes. Now we'll run our checks at the end.

Admin warnings and guardrails

• We added some clarifying language to note that you can't do email delivery to the U.S. President, even though they appear in the Target Groups options. Thanks to Amy at Win Without War and others for reporting!
• We added warnings not to use One-Click Signing and A/B Page Tests together to the Action Basics screen and the A/B Page Testing Dashboard. Thanks for David at ONE.org for the report!
• We'll now prevent you from using One-Click Signing with the Always Recognize Users feature. (You probably want Recognize Users Once if they haven't taken action.)
• If you've already disabled the Send Immediate Email Override for petition deliveries, we won't make you triple-confirm that you really want that every time you make changes to that page.
• The "YOUR ACTIONKIT TOOLS" section on the home page now hides any links to tools the user doesn't have permission to use. Thanks to Kathy at MoveOn for reporting the problem.
• Our help-desk vendor does not support attaching very large files; now we'll prevent you from submitting those in the support form. If you have a video of an error, we'd love to see it, just please send a link!
• In some circumstances, linebreaks in your support tickets could be lost, which we've now fixed. We like paragraphs! Thanks for Andrew @ Dream Corps for requesting the support improvements.

Sync

• The Salesforce and EveryAction syncs will now include users whose custom user fields have been updated either by a User Updater or an import that uses "Skip Action Creation".

Performance

• We improved the speed of the template history screen when many entries were present.
• We've made a series of changes to improve how quickly the Templateset History page loads, including paginating your results.

Minor additions and bug fixes

• In the REST API, you can now filter pages by whether they're included in reports of member actions (the real_actions column). Thanks to Third Bear working for ONE.org for the feature request!
• When merging users, you can now choose which user source to keep. Thanks to Brandt at New Blue Interactive for the request!
• We updated dead links to recurring mailing documentation which had moved. Thanks to MoveOn for reporting it!
• We fixed a bug where some user fields (like employer) would incorrectly not be associated with actions. Thanks to Kathy at MoveOn for the bug report!
• When building a new report in the Query Builder, the re-engagement list will now be excluded when calculating totals of subscribes and unsubscribes. Thanks to Oliver at Demand Progress for the request!
• We fixed a bug with 3-step navigation on donation pages that affected donors clicking "back" after a successful transaction.
• We fixed a problem where the |concatenate custom filter wouldn't work correctly if the first argument was a number. Thanks to Emma at Anne Lewis Strategies working for the DSCC for the bug report!

12/13/21¶

This release includes one mailing change you're likely to notice:

• When your mailing rebuild finishes, you no longer have to refresh the page to send or schedule. Thanks to Jase for the request circa 2016.
  
  

And a few others behind the scenes:

• We now send you a notification in the rare event your automatic subject line test mailing dies. Thanks to Andrea working for the Fetterman campaign for the bug report.
• The Proof and Send screen now truncates very long lists of targeting queries, and the Mailing SQL screen now truncates very long SQL targeting queries. Thanks to Gabi at MoveOn for the report.
• We added a splash more zoom to builds.

Other

• We already skip scheduled reports that don't send to anybody; now we'll also disable their schedules going forward. To re-enable, ensure that your scheduled report is set up to send to an email address.
• We fine-tuned the permissions needed to kill jobs. Now, you need a report permission to kill report jobs, and mailing editing permissions to kill mailing jobs.

12/1/21¶

Inline A/B Testing for Mailings

• You can test changes to the mailing body, custom fields (including content fields defined in your wrapper), and sender fields (From, Reply-To).
• Tests will be evenly distributed to your target audience.
• Results are shown with the same statistics provided for subject line tests.
• The tests are treated as a single mailing, so you will only see one mailing on the dashboard and only one mailing will need to rebuild if you change your targeting.

To start, set the toggle in the new A/B Testing section to on:

Enter the number of variations you want to test and add notes on the variations if you'd like.

Go to the element you want to test and click on the blue lab beaker symbol:

Then enter your content for the variations.

Once you're finished on the Compose screen, set your targeting and your limit and send your mailing just as you do for subject line tests currently. The standard mailing report will display results by variation. From the report you can select the winner and ActionKit will create a copy of the winning variation with the same targeting but no limit and excluding everyone who got the test.

11/2/21¶

User Groups

Over the years, many of you have asked how to remove tags from a user. But short of deleting all the user's actions associated with those tags, there's not a good way to do this. That's a big reason we created User Groups. They're similar to tags, but you can directly add users to and remove them from groups.

You can assign groups to pages (and users will be added to the group if they take action on the page), but you can also add them to a group or remove them from a group on the Change User screen, with an import or user updater, or via the REST API.

Read more about User Groups, or watch a short video about them!

False Click Filtering

Similar to last release, we will now filter out, where possible, false, machine-generated clicks. For those interested, all clicks (including these false clicks) are available in the core_click_raw table. This table contains full click data for the last 90 days, though we may narrow this window in the future.

Other

• We fixed a bug that prevented you from being able to use reports with parameters when exporting to Google Sheets. Thanks to Kenneth at Middle Seat working for the Fetterman campaign for the bug report!
• We enabled an option on the visual editor that should avoid garbling Outlook-specific conditional content entered with Microsoft's MSO tag syntax. Thanks to Reginald at Color of Change for letting us know about the problem.
• We fixed an error which was raised when saving special target groups with many targets. Thanks to Jordan at MomsRising for reporting the issue to us.
• We fixed a regression where certain admin URLs missing a slash were redirected without their query arguments. Thanks to David at One.org and Nicole at National Nurses United for the reports.
• We fixed an issue with the API where PATCHing orders would erase their import id. Thanks to Carl at FirstLook for noticing this one!

9/10/21¶

This release is focused on preparing for Apple's Mail Privacy Protection (MPP).

MPP is included as part of iOS 15, which may be released as soon as September 14th. Users of the built-in iOS Mail application will be presented a choice of whether to turn on MPP. If enabled, Apple will load all images in all emails for those users, including the pixels used for open tracking, so these users will appear to open every email, regardless of their actual engagement level.

In a recent ActionKit data sample, roughly 25% of opens came from iOS devices, so the impact will be substantial, even after factoring for folks who don't use the iOS Mail app or opt into MPP.

Beginning with this release, ActionKit will filter out the false opens generated by MPP. This prevents MPP users from being incorrectly identified as engaged forever.

This means the rollout of iOS 15 will cause a decrease in average open rates, not an increase. As a result, when evaluating mailing performance, we recommend looking at click or action rates rather than comparing against historical open rates alone.

Once iOS 15 has been out a while and more data is available, we'll update you on what we're seeing, and any more changes we're making, in the release notes. Watch this space!

False Open Filtering

As described above, we will now filter out, where possible, false, machine-generated opens. For analytics nerds, the full open stream, without any filtering, is available in core_open_raw. This table contains full open data for the previous 90 days, although we may narrow this window in the future.

New Column in summary_user - last_mailed

We added a new column to the summary_user table called last_mailed. This columns stores the last date, within the last 365 days, when a user received a mailing from you. Thanks to Jin Ding working for Action PAC for the suggestion!

Django Upgrade

We've completed a project to upgrade the underlying Django code-base used by ActionKit to the latest release, version 3.2.6.

ActBlue Error Handling

If ActBlue sends a request with an invalid account name to the webhook we'll return an error immediately to ActBlue. This will help catch webhook misconfigurations earlier.

New Template Filter: splitlines

We added a |splitlines template filter which splits a value on newlines. You can iterate over the results.

8/26/21¶

AMP for Email Support (beta)

AMP for Email allows you to send emails to users with fully-functioning forms embedded in the mailing. For example, this means that instead of linking to a survey, you can embed the survey in the email directly -- and users can complete the survey form without ever leaving their email.

AMP is supported by many email clients, but users who open your mailing with an email client that doesn't support AMP will see your regular HTML mailing.

To take advantage of AMP, read more about how to set it up.

This is a beta release. There will be sharp edges and getting it working, especially the trickier bits, will definitely require some elbow grease. Let us know if you run into bumps in the road and we welcome your feedback on how to make things easier!

Faster and Easier Re-engagement

We updated the Re-Engagement Settings screen so you can now edit the SQL for your re-engagement queries more easily. Thank you to Jase at 350 and Third Bear working for Color of Change for the requests!

We now display Dashboards tagged "reengagement" on the Re-engagement reports screen. Thanks to Brandon at MercyCorps for the request!

We also did some performance tuning on re-engagement jobs and they now run much faster than before.

Query Builder

We added a bit more visual space around the contents of AND and OR groups in the query builder so that if you're constructing complicated boolean expressions it is easier to follow which items are nested where. Thanks to Andrew at Dream Corps for pointing out the problem.

We've also added an option to filter for past-due recurring orders to a place where it was missing in the donations query builder. Thanks to Marie at NRDC for reporting the oversight.

Faster Querying on Email Domain

We added an email_domain column to the core_user table. It's indexed, so this will make querying and reporting on user email domains more convenient and speedier. Existing SQL that uses substring_index(email, '@', -1) will also take advantage of this index without changes. This change is already available in all client instances.

Prefix Collection for Senate Signature Delivery

We added example code to collect prefixes from the fixed list supported by the Senate's Communicating with Congress signature delivery system to the thanks.html template in our Original template set.

Please note: the Senate's Communicating with Congress API has a frustratingly limited set of allowed prefixes. We and other groups have flagged this for the CWC team and we hope it will be improved in the future but, for now, the list cannot be added to or changed.

Other

Upcoming Events Count

• The count of upcoming events on the list of campaigns is now consistent with the upcoming count shown elsewhere. Thanks to Nicole at National Nurses United for the report.

Safer Github Pushes

• We've added a check to ensure that when you push code to a repository for a templateset linked to GitHub, it won't cause an error or break your pages. (This was already in place for non-GitHub-connected templatesets.)

Email Wrapper Fields

• We fixed a problem where copying an email wrapper wouldn't copy its custom email wrapper fields. Thanks to Lindsay at Nova Scotia NDP for the bug report.

7/21/21¶

Deliver Signatures to the Senate with CWC

We've added support for the Senate's version of Communicating With Congress! This means that your petitions to the Senate can now use the Senate's preferred delivery mechanism.

Sadly, the Senate decided to require a particular set of name prefixes for signatures: Mr., Mrs., Miss, Ms. and Dr. are the only prefixes their system supports. To provide additional flexibility in how this is presented to your users, we allow you to override ActionKit's normal prefix field with an action field called "cwc_prefix." Depending on your use case, you could use this capability to provide separate handling for a user's true preferred name prefix as opposed to the more-restricted list used for signature deliveries, so that ActionKit knows that they would preferred to be addressed as "Mx. Sam Browne" but will use "Ms. Sam Browne" for their Senate submission. There are several ways this choice could be presented to users; contact support if you're not sure how to set it up and we can share some sample code.

Report to Custom User Field Import

Lots of clients have developed use cases that involve running reports and then importing data from the results into custom user fields; we've made this process much easier by cutting the number of steps necessary. You can also keep these fields updated on a schedule!

To start, you'll create a report with the data that you want to put into a custom user field. (Make sure you create this custom user field ahead of time!) In this example, I'm creating a report that tells me how much money a user can donate before they "max out". (This example specifically applies to candidates and parties, and may be different in your area.)

Running the report, I see that user 1 has $1,000 remaining before they max out:

Next, I need to create a User Updater (from the Reports or Users tab) for this report and run it:

After it runs, I can check the User Summary page for user 1 and see a value of $1000 for their maxout_amount custom user field:

Admin Search As You Type

The admin searchbox now has super powers!

From any tab you can search Pages, Mailings, Reports, and Users (provided you have the necessary permissions). Search will offer suggestions as you type.

Or, click the arrow in the search box to choose a specific category:

The category groups include related models, so searching the Pages + category will suggest Templatesets too.

You can even search the ActionKit manual!

And you can start your search and then switch categories. For example, you could start a search from the Support Tab, then realize you want to search Reports+, or Pages+

You can still use the previous search. Just type in your search term and hit enter to run the tab-specific search that you’re used to.

Other

Embedded Dashboards

• Charts and tables in built-in dashboards (Mailing Dash, Draft Dash, User Dash, Event Dash, Campaign Dash) now render with full functionality, so if your dashboard has a line/bar/pie/etc chart, or sortable table, you can now see and interact with these on the Proof and Send screen, Mailing Report screen, User Summary screen, Manage Event screen, and Campaign Dashboard screen. Thanks to Julia at 350 for suggesting this enhancement!

Event Template

• The "event_attendee_tools.html" template previously constructed the "cancel signup" URL like this: {% templatetag openblock %} url 'events.views.cancel_signup' event.local_campaign.create_page.name event.id {% templatetag closeblock %}

  Now it does so like this: {% templatetag openblock %} url 'cancel_signup' event.local_campaign.create_page.name event.id {% templatetag closeblock %}

  We'll automatically patch your templates where possible, but if you have the old version in a github repository, you should change it to the new version above. (The original URL will be supported for now, but not forever.)

Drag and Drop Editor

• We fixed an issue that could cause default font size, color, and related styles to be ignored in the Drag and Drop Editor.

Engagement Queries

• We sped up the default re-engagement reports by making them use the new summary_user table when possible.

Advanced Search Results "Next Page" Link Fixed

• When using the admin interface's advanced search feature, the links to browse to the next page of results caused the search criteria to be wiped out, so you could only ever see the first 100 matches. This is fixed now, with thanks to Ismael at Color of Change for reporting the issue.

EveryAction Integration

• We've added support for vanity EveryAction URLs in the the EveryAction integration. If you have a non-standard URL that you'd prefer to use to access the EveryAction admin via links from ActionKit please let us know and we can update your configuration. Thanks to Lee Henderson at EveryTown for the request.

Salesforce Integration

• We fixed an issue that could cause the Salesforce sync to format donation data in unexpected ways. Thanks to ThirdBear working on behalf of DreamCorps for the report.

Small bugs

• We fixed an issue that caused one Congressional Rep's contacts to be omitted; thanks to Amy @ Win Without War for reporting.

• We fixed a bug that was caused a few ActBlue express donations to fail to load into ActionKit. Affected donations have been reprocessed successfully. Thanks to Sophie at MoveOn for the report.

6/2/21¶

Drag-and-Drop Mailing Editor

We're thrilled to announce a new option to make it easier to build complex mailing layouts: the drag-and-drop mailing editor. It doesn't replace the existing code and visual editors—they're still there for direct control of your HTML—but provides a more visual alternative:

The drag-and-drop editor also offers interesting design options like grid layouts with rows and columns and options to hide blocks of content on mobile or desktop.

To make the editor available in your ActionKit instance, a superuser needs to go to the "Configure ActionKit" screen and enable it in the "Admin Settings" section at top right, shown below.

Once the feature is enabled, you can still choose whether or not to use it mailing-by-mailing, or even change your mind while working on a mailing. To switch, use the "Editor" toggle that will appear at the end of the "Basics" section of your mailing compose screen:

Much more info about the drag-and-drop editor is available in the documentation. We'd like to thank Theirworld for early feedback on the feature.

Query Builder

You can now filter clicks and actions based on the browser (user agent) used to create them. For example, you can now build a query for mobile clicks by date:

This adds to existing support for browser info in the Display Columns section. Remember that user agents are only tracked for actions since last release.

ActBlue Integration

We've changed how our ActBlue integration handles addresses received for ActBlue Express donations. ActBlue Express gifts are one-click, so they don't prompt the user for address data. As a result, the addresses we receive with those gifts can be months or even years out of date. This can result in overwriting fresher address data on the ActionKit side.

When we already have an address for a user, Express donation addresses will not update core_user. They will still go to core_order_user_detail for the donation. Additionally, when using Donation-Only/Compliance Mode in the EveryAction sync, these addresses will be ignored unless they are the only donation address we have for a user.

Thanks to Everytown for a detailed description of the issue and helping to puzzle out how this should work.

EveryAction Sync

• We've improved our tracking of errors in the EveryAction integration. Two new tables are available, core_everyactionorderfailedsync and core_everyactiontransactionfailedsync, which can be used to report on failures to send contribution data to EveryAction. Additionally, failures to send user data to EveryAction are now shown in the user admin:
  
• We fixed a bug that could break the EveryAction integration if you had a merge query used to generate source codes that didn't include every order being sent to EveryAction. Thanks to Kristin Peña at People for the American Way for reporting this one.
• We've improved how date fields are handled in the EveryAction integration. You can now map new date fields like Date Deposited and they will get be converted automatically into an EveryAction-compatible Eastern Time date. Thanks to Everytown for the request.

Salesforce Sync

• Previously you couldn't sync $0 orders to Salesforce if you also utilized a trans_id mapping to prevent duplicates. That's been fixed now, and we've added docs on the sync's handling of $0 orders. Thanks to Shawn at J Street for the request.

Bugfixes and Internals

• We fixed an issue with the Twitter card meta tags in the Original templateset. In your custom templatesets, if you'd like your shares to feature a larger image when they appear in Twitter, you can change the content of the twitter:card meta tag from summary to summary_large_image.
• Petition and call pages would sometimes incorrectly recognize users who were missing address details needed to find their legislative targets. We'll now correctly show a contact info form to those users. Thanks to Caitlin at Courage for the detailed report.
• We reverted a recent change to the format of custom event fields in the REST API. Thanks to our colleague Kyle at Mobilize for the report.
• We fixed a situation where rate-limited mailings could send slower than intended.
• Our code to detect "TK" placeholders in emails and prevent sending was incorrectly activated by references to the Tk'emlúps te Secwépemc First Nation community. We've added an exception to avoid this. Thanks to 350.org and the British Columbia NDP for reporting.
• Behind the scenes, we're in the process of upgrading to a more recent release of the Django framework that ActionKit is built on. This release includes a minor Django version upgrade.

5/11/21¶

Reports

You can now export report results to Google Sheets with the click of a button! The first time you export, you'll need to authorize ActionKit to have access to your Google Drive in order to complete the exports, but once you've done that, exports are quick and easy!

Actions

We already tracked user agents for opens and clicks, going forward we track for actions too. Check it out in the Actions Query Builder. Thanks to many for requests on this, most recently Jase at 350.org.

Admin

You can now find users by email from the ActionKit header search box.

Also, the fields on the delivery options screen were not showing up under the correct headers. We fixed them! Thanks to Jordan at MomsRising for pointing out the problem.

Mailings

We fixed a problem where Video blocks didn't work correctly and a bug in the image file viewer in the drag-and-drop mailing editor. Thanks to Tom Lavelle and Jamie Lonie at Their World for the reports!

Templates

We added a new template filter, at_most, that allows you to provide a maximum value. For example, if suggested_ask is 3200 and value is 2800: {​{ suggested_ask|at_most:2800 }} will return 2800. We also added at_least, which allows you to provide a minimum value. For example, if suggested_ask is 100, {​{ hpc|at_least:200 }} will return 200.

Integrations

We added a new mode for the EveryAction sync called "Compliance Mode" which only sends Contact updates for donations and sources user address data from the order user detail table. Thank you to Brooke Heller and Lee Henderson from EveryTown for helping us figure out how this should work.

We improved the EveryAction sync to always send date values in Eastern Time which is the timezone used in EveryAction. Thank you to Lee Henderson at EveryTown for the request here.

4/21/21¶

Better Email Blocking

Usually you want members to receive your email, but sometimes you don't. So we've made it easier to avoid emailing certain email addresses.

You've been able to block recipients by domain or email address years. We've now extended that feature in a few ways. You can now block emails containing certain strings. For example, you can avoid mailing any address that contains the string "spam" or ".gov".

Blocked users won't be included in mailing counts and will be assigned a subscription status of 'blocked' in the database. You can use longer lists now, too.

You can configure blocking options through the Mailings tab, under List Hygiene in the right-hand menu.

They're also available via the REST API resources blackholedemail, blackholeddomain, and blackholedpattern.

Consult the documentation for more info and contact Support if you have questions.

Events

We added a count of open, upcoming events to the campaign dashboard:

We've also documented a little-known REST API endpoint for event searches, and gave it support for custom event fields. Thanks to Lee at Everytown for the suggestion.

Staff

We sometimes hear of new staff finding themselves unexpectedly blocked from the ActionKit admin, because the "Admin Interface" checkbox on their staff profile isn't checked. To help avoid this, the "Admin Interface" option is now pre-checked when you create a staff user:

Everything Else

• We now note in the Mailing History page when a mailing's build has been invalidated due to changing a mailing's targeting query report's SQL as well as other indirect changes.
• Import pages were cluttering up the list of available landing pages for mailings, so they've been removed.
• We fixed a bug where some timed send drafts displayed as "generating" despite being drafts. Thanks to Elijah at Ontario NDP for the report.
• A mailing test group could die if you had added new entries to your seed list before sending, but now that's fixed. Thanks to Bianca at 350 and Mais at The Syria Campaign for the report.
• We fixed an issue on donation pages effecting very old olde browsers. Thanks to Brandon at MercyCorps for the report.
• We made a small change to Original's petition.html, to use a div tag instead of a paragraph for the lead-in. Thank to Third Bear working for Kairos for the request.
• We fixed two issues with international targets, including one affecting last names of some UK Members of Parliament. Thanks to David and Tamara at One.org for the report.
• We fixed a bug that could result in a merge loop when automatic user merge was enabled, thanks to Eileen at DSA for the report.
• Users now get only one unsubscribe confirmation email per day, even if they manage to unsubscribe multiple times.

4/5/21¶

Mailings

Campaigners sometimes rebuild or change targeting on a mailing not realizing that it will cause other mailings to need rebuilds. We'll now let you know what other rebuilds will be required, and ask you if you're sure if you still want to go ahead with your rebuild or targeting change.

Targeting

We updated our vendor for U.S. federal legislators, and have loaded district offices for all of these targets. Please let us know if you see any inaccurate data or hear feedback from legislator offices.

We now support targeting non-voting delegates to the U.S. House from DC, PR, VI, AS, GU, and MP. If that doesn't bring about DC statehood, what will? Go to Pages -> Targets -> Legislative Target Groups -> Add to create a group, and select "U.S. House Delegates" as the type. Thanks to Amy at Win Without War most recently, and many others over the years, for requesting we end taxation without target-action in the District.

Users

We added a way to differentiate between users that have been merged and the primary users on the Users tab. Thanks to Dominique at Pollinis for the request!

We also added some more documentation about our new permanent user merge feature.

Pages

We fixed an issue where lists inside the "talking points" section of a Letter-to-the-Editor page were not visible. The Original/lte.html template has been patched, and others where possible. Thank you to Jin on behalf of Grassroots Law for reporting the issue.

Events

We added a new column to the Event Campaigns listing showing you the number of upcoming events in addition to the number of total events, to make it easier to see which campaigns are in the past and which are current.

Reports

When working with a query that uses type-to-search fields to specify parameters, the values you entered are no longer lost when the query is run, so you don't have to re-enter them to run the query a second time. Thanks to Third Bear and Jase for bringing this issue to our attention.

Languages

Hiding a language made it impossible to unset email wrapper and template set defaults for that language. We've made it harder to get into this situation. Thank you to Andreea at 350 for bringing it to our attention.

Staff

Sometimes, when creating an ActionKit admin account for a new staff member, someone would leave the "Admin Access" checkbox unchecked by accident. Previously, this led to a confusing result: if they user tried to log in, they were bounced back to the login page without an error message. Now we'll show a more specific error message indicating what happened.

EveryAction Sync

We've add endpoints to our REST API to allow you to manipulate the user, order, and transaction mappings created by the EveryAction integration.

We improved error handling in the EveryAction integration to address problems found during the last release. Thank you to Lee at Everytown for Gun Safety and Bryan at RepresentUs for reporting the bugs.

File Uploads

We upgraded the third-party code we use to handle some kinds of file uploads (including end-user file attachments in action forms) to a more recent version that has better support for iOS devices.

We don't expect a lot of people to be uploading merge files to the admin interface from your iPhone, but this will allow more of your users to upload photos from a mobile device straight into an action form. Thanks to Kathy at MoveOn for reporting the problem.

Donations

The currency account switcher is now supported for Braintree donation pages using 3D Secure 2.0.

3/11/21¶

Permanent User Merges

ActionKit's user merge offers a way to collapse multiple user records into one, moving action history into a single user account. This is helpful when you end up with one person with different email addresses and you want to see all of the user's activity in a single place. Previously this was quickly undone if the user took taking action again with multiple email addresses. Enter Permanent User Merges - a new configuration option:

With this setting checked your user merges will be permanent, meaning if a merged user submits an action or donation with a secondary email that you previously merged, the action will be automatically merged to the user record with the primary email.

The email the user submitted with will receive the after action confirmation if you set one up for the page but secondary emails will not be resubscribed so they won't receive bulk mailings sent from the Mailings Tab.

When you have this configuration option checked you'll also get the option to disconnect a merged user on the user admin page. This does not move historical actions back to the secondary user profiles but future actions by the secondary user will be attributed to that user and will resubscribe the user.

Thanks to Shawn Clement from J Street for the detailed feature request.

Query Builder and Reporting Improvements

Reporting gets some upgrades in this release:

Zip radius searches in the Query Builder are now much faster.

We added most recent phone number to the available display fields.

When you run a report, if you email yourself the results after the report finished running, we re-ran the report and then emailed you the results. Now, we'll just email you the results immediately. Thanks to Tamara at ONE for the request!

EveryAction Integration

The EveryAction Integration continues to be a hotbed of testing and fixes. Let us know if you'd like to join the beta. In this release:

We added support for ActBlue donations that transform from one-time to recurring. Previously these caused errors after they'd been upgraded in ActionKit.

We fixed a bug that resulted in the wrong total being sent for one-time orders which had been partially refunded before being sent to EveryAction.

We fixed a problem which was preventing some Contact updates from being sent to EveryAction when more than 10,000 updates needed to be sent.

Thank you to Lee Henderson at EveryTown for reporting all three of these and for all the help improving the integration working.

Other Changes

We have released support for 3D Secure 2.0 for Braintree accounts to ensure transactions are compliant with Strong Customer Authentication requirements.

We fixed an issue where special targets with blank country values could not be updated. Thank you to Brittany at NRDC for reporting the issue!

We made some improvements to international geocoding to ensure users always end up with the country they entered.

Uploading a spatial data file to an existing custom boundary group replaces boundaries with the same name, rather than erroring. Thanks to Patrick at NRDC for bringing this to our attention.

Using certain email targeting options with the Also Include feature previously caused slow or hanging queries, which we've now fixed. Thanks to Marisa at J Street and Jordan at MomsRising for reporting.

It's now possible to specify which list you would like to subscribe or unsubscribe a user to in your CSV file when uploading. This allows you to subscribe people to multiple lists in a single upload. This is done by including a "lists" or "unsub_lists" column in your file. Thanks to Daniel from National Nurses United for the request!

All "letter to the editor" pages require the user to enter their name and mailing address, because media typically will not print letters without having this information. When you create an LTE page and check the "customize fields" option, we make sure these fields are visible and marked as required so that you can't remove them -- but as a curious side-effect of the way this code was implemented, you could actually add those name and address fields to the page a second time, which made the page unusable because the system doesn't expect to ever find two different name or address fields on the same action form. We now properly disable those options so you can't break your LTE page in this way.

We fixed a problem where if you didn't set the About text for your page, you wouldn't be able to customize the share description for social media. Thanks to Third Bear working for Kairos and Dominique at Pollinis for the reports!

2/17/21¶

ActBlue and EveryAction Sync

We improved our support for ActBlue donation data in the EveryAction integration, addressing several bugs in the way refunds were handled.

We improved support for sending reversed orders and canceled recurring profiles in the EveryAction integration, which now handles the case where the reversal/cancellation happens before the original record was sent to EveryAction.

We've fixed a bug in the EveryAction integration where certain country codes allowed in ActionKit were not allowed in EveryAction, which could cause the integration to fail.

Thanks to Lee Henderson at Everytown for help identifying these bugs!

U.S. Legislative Targets

We now have names, email addresses, and phone numbers for almost all U.S. legislative targets. District offices for new members of Congress are still outstanding.

Some state legislator targets were missing phone numbers, which we've corrected. Thanks to MoveOn for calling our attention to it!

We corrected several state legislators whose names were spelled incorrectly, without accented characters. Thanks to Maggie and Jordan at MomsRising for noticing and mentioning it to us.

Thanks to NRDC for supplying email addresses for members of the Illinois State Senate.

We had the worst person in the United States as president for four years. A recent election corrected that error; the change is reflected in the U.S. President Custom Target Group.

Reports

Thanks Andrew at Dream Corps for reporting that the "churn" column was not displaying in the standard List Progress report. We fixed the issue.

We fixed an error in the code the "Pages" query builder used to calculate the sum or average of payments on a given page. Thanks to Nathan at MomsRising for the report.

We added a new table called summary_user, which contains the dates a user has most recently opened, clicked, or taken action from a mailing, among other useful stats. This is significantly faster than querying on tables like core_usermailing.

Donations

We now display more detailed errors for ACH donation errors. Thanks to Ty and Rebecca at DSA for the request.

We refactored the ActionKit Braintree Javascript integration so that it's easier to intercept the submit event, for example, to do an interstitial ask, or provide custom validation. Thanks to Aili at MoveOn and others for requesting this feature.

We fixed an issue where a non-whole number default donation amount would not show as the default. Thanks to Bianca at 350.org for reporting this.

Quality of Life

For clients with many tags, browsing pages in the admin was painfully slow. We improved the speed by only showing the 100 most-used tags in the sidebar filter. You can search for other tags in the search bar.

1/5/21¶

New State and Federal Legislative Target Data (Partial)

As the prophecy foretold, most newly-elected state legislators, at least for the majority of states that are already sworn in, will arrive in your instance by tomorrow morning. We have switched our vendor for US state legislator data to KnowWho and they expect to release the remaining states (Alaska, Arizona, Arkansas, Georgia, Iowa, Kansas, New Mexico, Oregon, Washington, South Dakota, Texas, Colorado and Illinois) next week.

We'll be updating federal legislators by tomorrow as well. Contacts and district offices will be added as they become available.

Yet More Zoom!

We added updated_at and created_at indexes to tables that were missing them. This should speed up some reports, as well as third-party sync queries on dedicated replicas.

Also, most mailing screens load much faster than before. The largest improvements are on the Mailing Targeting screen, which loads four times faster and the "Rebuilding" section on the Mailings Tab, which can load 10x times faster!

EA and SF Syncs

We released various fixes for syncing donations and handling financial batches with EveryAction. Thanks to beta testers at Everytown and Represent.Us. Submit a support ticket if you're interested in joining the beta!

We added a notice to the Salesforce Field Mappings screens to clarify that if your sync settings are configured to only send data from AK to SF or SF to AK (but not in both directions), then bi-directional field mappings will still only send data in one direction. Thanks to Jackie and Ethan at Third Bear working for Dream Corps for the report!

Mailings

If you have a mailing that uses an hourly cached report in its targeting, we'll refresh the cache just before it expires, to help your mailings build even faster. This was inspired by Nissa, working for ECU.

We now show a warning if you use {{ "{" }}{ suggested_ask }{{ "}" }} in a mailing with a donation page that doesn't have a suggested ask rule. Thanks to Nathan at Faithful America for the report.

We adjusted the Re-engagement Overview and Settings screens to make it clearer when you have an active re-engagement job running. Thanks to Amy at Win Without War for the report!

Other

• We've added support for Canadian dollars using Authorize.net, in addition to the previously existing support through Braintree. Thanks to Lindsay at the Ontario NDP for suggesting this.
• We improved emoji support! 😮✨🎉 Most text fields now accept emoji, including page content and custom fields. Some exceptions remain, like combined Name fields on action forms (which filter out the emoji) and user/click sources.
• You can now delete survey questions via the REST API. Thanks to Ethan and Jackie at Third Bear working for ONE for the request!
• We've tightened our anti-spam check for links in names to catch some links that got through previously, and added exceptions for some names and titles that could look like links to our code.
• We had accidentally removed the Page from Model button from the Pages tab menu. Sorry about that! It's back! Thanks Joe from Everytown for the report.
• We fixed a problem where you could create a GitHub connection for a templateset using the same branch for the live and preview versions. This would cause problems in previewing, so you can't do that anymore. Thanks to Rachel at 350 for the report!

11/17/20¶

Even More ZOOM!!!

New release, new zoom! We've got a bunch of speed improvements coming soon to an ActionKit near you.

Admin pages that display lots of minidashes are now much faster to load. That includes lists of mailings and pages. There's also a significant improvement in load times for the Pages tab and some related pages. (We'd understand if you have to go hit the Pages Tab a few times just now to see for yourself.)

We also sprinkled more zoom flakes on mailing build times. Mailings that use a lot of cached reports or target using other mailings now build up to 8 times faster. That's 800%!

Self Serve DB

Good news, you can now manage your own MySQL accounts for the shared reporting replica, if you're a superuser with two-factor authentication enabled, instead of needing to ask us through support. These accounts are necessary for direct database connections.

Each staff user's permissions page now indicates whether the staffer has a MySQL account. You can create a MySQL account if the staff doesn't already have one.

Or if they already have an account, but it isn't associated with the staffer, you can connect the two:

MySQL account management is limited to superusers with two-factor authentication enabled. Want to know who does or doesn't have 2FA enabled? That's now a staff filter.

If you have a dedicated replica you'll still need to contact ActionKit support to manage those accounts.

Paste Multiple Preview Lines Too

When composing a mailing, you can now paste in multiple preview lines just as you can paste in subjects. Once you have multiple subjects, paste multiple lines into the preview text box to set preview text for all of them.

Mailer

The Mailer Limited Send Size setting now uses an absolute number of recipients. If you customized the setting, we'll use your custom percentage and current list size to set the absolute number. If you left the setting alone, we'll set the absolute limit to 5% of your list size up to a maximum of 10,000. If you use the limited send feature, you may want to review the new value and make sure it's in line with what you want.

Superusers, go to the Configuration > Mailer Settings > Mailer Limited Send Size to make changes.

We fixed a problem that sometimes caused mailings targeted to constituents of a legislative group to build very slowly. Thanks to Jenn at MoveOn for reporting the issue.

We fixed a bug where submitting an edit to a mailing's content at the exact moment it finished rebuilding could result in the mailing staying marked as building until a new build was submitted. This was most recently reported by Annie at Indivisible.

We fixed a bug that prevented certain mailings being used in targeting. Thanks to Jennie working for Jamaal Bowman for the most recent report.

Targets

It's easier to find which US legislators and built-in international targets have phone numbers or email addresses on file. Since most targets have both, we've added an icon to the target group admin screen to show where one is missing.

Thanks to Brittany at NRDC for the request.

You can now Bulk Edit to show or hide lots of Legislative and Custom target groups at once. Thanks to Joe at Everytown for suggesting!

We fixed a bug that allowed international users to take action without providing an address sufficient to identify their target. For Canada and UK MPs, we now really require postal code and country.

We added a new custom snippet type for Petition Delivery PDFs. You can add new custom snippets from the Config screen. Thanks to Brittany at NRDC for suggesting this too!

Salesforce

For users in the Salesforce sync, you can now trigger an instant sync from the user profile by clicking "Sync Now". Thanks to Shawn at JStreet for the suggestion.

And you can remove a user from the sync by clicking "Disconnect User". We've added docs on how to go about disconnecting a user. Requested by Mark working for FreePress.

Everything Else

• We've added documentation on the recently added user-facing file uploads, prompted by questions from Eloise at StandUp America.
• We've added a new report called Users Taking Action After Merge to help you find (and merge!) users who have taken action again after being merged. We also fixed an error that could occur when performing multiple user merges at the same time.
• A recent release added rate-limiting as an anti-spam tool. With this release, actions caught by the rate-limiter are no longer saved. This release also extends name checking to catch more spammy links.
• When displaying or filtering on user phone numbers in the query builders, you'll find some new "digits only" choices, which can be helpful for exporting or filtering. Thanks to Nicole at National Nurses United for suggesting this feature.
• Custom user field names are normalized to lowercase before saving from a page. Thanks to Rebecca at DSA for reporting a bug that led to this change.
• We fixed a bug with multiple-value parameters for re-engagement reports. Thanks to Sophie at MoveOn for helping us discover the problem.
• Petition action resources in the API link to the actions targets, as with call and letter actions. Thanks to Third Bear (on behalf of One.org) for reporting this omission!
• We fixed a bug that prevented page validation from catching some form values that were required but blank. Thanks to Rachel at 350 for reporting.
• We fixed a bug in the display of the selected default Query Template. Thanks to Jase at 350 for reporting it.

10/14/20¶

ZOOM!!

We've improved the page load times for nearly every screen in the ActionKit admin. For example, the Reports Tab now loads 30 times faster! I was so excited I spent several minutes just hitting reload. (Sad but true.)

Most of the performance work doesn't lead to visible changes, except: we now only show 25 mailings of a type on the mailing summary screen instead of 75.

We also:

• Optimized mailings that use a merge query or merge file for targeting so that they run faster and more efficiently.
• Reduced the load time of the autocomplete widgets by more than 65%.
• Improved rebuild times significantly for mailings that use a lot of cached queries or exclude a lot of other mailings. Maximum build times have been reduced by over 70-80% and average build times have been reduced by more than 50% across the board.

File Upload In Action Forms

We've added native support for accepting file uploads from users within your action forms. There's a new question type both in the survey builder and in the user-form-field customization options. You can restrict uploads to just images, or accept videos or document files. Uploaded files are stored in your AWS S3 bucket, using private URLs that allow you to download them without making them accessible to the public.

This feature does not work with pages that are hosted outside of ActionKit; contact us if you have a use case that would benefit from that capability. We've tested this feature on a variety of browsers, but let us know if you encounter any rough edges.

International Enhancements

We will now populate a user's city and region if they supplied a postal code when taking action.

We have improved postal-only geocoding for countries outside the United States. This was prompted by a report from Felix at ONE about issues with Canadian postal codes -- thank you!

We added a type to the display of international divisions so on your user admin pages you'll see "Constituency" for UK constituencies, and "Riding" for Canadian federal electoral districts. Thanks to David at ONE for suggesting this addition.

We added state, and if that's not available, region, to the Original print template for delivery PDFs. You can still customize PDFs however you want!

We improved the way we display error messages for form fields which have been hidden, such as the zip code or postal code fields which are hidden as you toggle between US and international addresses.

Mailings Bug Fixes

At long last, you can now specify users to view proofs for by email address as well as user_id. This was requested over the years by Jase for DFA, Michael for First Look Media and Shayna for Win Without War, among others. Thank you all!

We've edited the subject line for final mailing proofs for timed send mailings to note when they'll be delivered. Thanks to Erick at Presente for suggesting this improvement!

In a recent release, we added a check to let you know when you needed to exclude people who recently received a recurring mailing series, but that warning could misfire if you entered 0 for the series. This is now fixed -- thanks to Jessie at FCNL for the report!

We fixed a bug that prevented a recurring mailing series from stopping if you pushed stop at the moment that a mailing in the series was preparing to be sent. Thanks to Nicole from National Nurses United for helping us battle the undead.

We fixed a bug that could result in getting too few users when targeting a mailing with "Also Include" OR'ed criteria. Thanks to Aaron on behalf of Verified for reporting the MIAs.

Batch Delivery

You can now select which columns to show when delivering a CSV file of signatures to targets. With this change, you can hide users' full addresses, show international addresses, and include additional information like phone numbers. Thanks for the user cases to Kara at ONE, Caitlin at Courage and Virginia working for Ayanna Pressley.

When receiving a batch delivery proof, you'll now get a big red warning that this is a test message, much like you receive for one-off delivery proofs. Thanks to Emily working for 350 for the request.

REST API

You can now view which form types a user form field is associated with and filter UserFormFields by form types in the REST API. Thanks to Third Bear and Sky at MoveOn for the requests.

We made the relationship between custom boundaries and targets visible in the REST API. Thanks to Third Bear for requesting on behalf of ONE.

Other

• To frustrate some spam bots, ActionKit by default now allows only 20 actions from a single IP per minute. This is a limit that we set based on reviewing months of logs and confirming that this would only block spammy requests.
  
  API requests using a username and password are not rate-limited and, for now, unauthenticated submissions against /rest/v1/action/ are not rate-limited.
  
  You can disable the limit under Spam Settings on the Config screen. Read more in the docs, and please contact us if you have questions or issues.
• We told you that if you used the importer's fast user field upload feature and only included an email, akid or user_id that we would automatically fallback to a normal import. In some cases, that was a lie.
  
  We now automatically turn off the fast user field upload option if you upload a file with only an email, akid, or user_id column. Really. We mean it this time.
• If we know that your report results has too many rows, then we won't show the "Email report results (as table)" section anymore, since your only valid option is to download the results or email yourself the file.
• It was easy to confuse snippets like {% verbatim %}{{ context.targets.title_last }}{% endverbatim %} (used on pages) and {% verbatim %}{{ targets.title_last }}{% endverbatim %} (used in mailings), especially when copy/pasting portions of a template from a page or mailing, so now we allow you to use these snippets interchangeably. Thanks to Senator Jo Comerford, formerly of MoveOn for the original request.
• We fixed a bug that caused the express_lane custom user field to not be updated with information from ActBlue in some client instances. If this affected you, we’ll update the record in your database to fill in the missing information.
• On the Action History and Transactional Mailing History pages of a user's record, we now display the timestamps in the staff user's time zone instead of server time. Thanks to Brandon at Mercy Corps for the request.
• In some cases, the recorded time for tracked clicks could be off by a few seconds. Now it's not. Thanks to Adam at MoveOn for noticing the problem!
• Custom fields using the "numbers" field type now use text behind the scenes; this prevents a rare HTML bug if you had an invalid number in your custom field and the custom fields section collapsed when you tried to save that would leave you unable to save your page until you either fixed the error or uncollapsed the custom fields section. Thanks to Josue at NRDC for finding this one!
• Previously you'd get an unhelpful error trying to create custom boundaries by uploading a GeoJSON file that contained both polygon and multipolygon features. We now show a validation error and we've added the requirement that all of the geometries in the data must be a single type to the documentation. Thanks to Vanessa at Pollinis and Ben at ProgressNow for reporting the error.

9/23/20¶

Snippets

We've got a bunch of improvements to snippets in this release.

We've added snippets to the Compose Mailing screen for your page content that you enter when setting up Petition, Letter, Call, and other types of pages.

Select your page from the "Landing Page" dropdown, then select the content you want to include for that page from under the renamed "Landing Pages" submenu. The snippets are divided by page type.

We also cleaned up some of the snippets menus when you're editing Pages to only show you snippets that are relevant to that Page's type.

We updated the snippets menus on the delivery job page to fix some broken snippets.

Finally, we removed some broken snippets on the Delivery screen for Petitions and Letters.

Events

To facilitate organizing online and international events, we now save each event's time zone in a new column in the database. You can display this time zone in user-facing templates with {% verbatim %}{{ event.local_timezone|timezone_display }}{% endverbatim %} or query it from the events_event.timezone column. You can translate the names of time zones into other languages; see the documentation of the timezone_display filter for details.

We’ve made a few changes to the Original template set. We attempt to patch these to your templates, but if you don’t see these, we’ve outlined the changes in the documentation:

• Region added to the Event Create template; region will display if the country selected is not the United States, so users can specify the relevant Canadian province, French department, etc.
• Changes to event_search_results.html can speed up displays of the map if you have hundreds of events. Although we made several different change to this template, you can get most of the speed benefit by ensuring that this one short bit of modified JavaScript appears in your templateset: “Speed up map display by adding markers in bulk”
• We fixed a bug where if you had moderation set up for your event campaign and you edited an event while Acting as Host, we would redirect you to the Moderator Tools page instead of the Host Tools page. If you are still being redirected to the Moderator Tools page after Acting as Host, you may need to update your templateset to pass the host_akid URL parameter.

Other

• If your page's after-action Redirect URL goes to ActBlue, we'll now fill the akid into the refcode2/refcode URL parameter, just like we do for /go/ redirect URLs and mailings. Thanks to Brandt working for Our Revolution for the request.
• The REST API no longer requires trailing slashes! Thanks to everyone who's reported trouble with this.
• Using the API to change orders with no import IDs resulted in invalid duplicate errors. This has been fixed. Thank you to Brandon at MercyCorps and Lee at Everytown for reporting it.
• We've added SVGs to the list of image types we exclude from link redirection. Thanks to Aaron at Birdhouse working for Pollinis for the request!
• We've fixed a problem where A/B tests were left running on pages the test was no longer attached to. Now, unattaching a page from an A/B test will end the trial for that page.
• The Actions query builder now knows how to display and filter on the subject and letter text of letters to the editor. Thanks to Emily @ MiddleSeat for 350 and Liz @ CBD for requesting this feature.
• If you don't have the permission to Manage Jobs and stop them, we now hide the button instead of showing you an empty list of jobs. Thanks to Phillip at ONE for the report.
• The "rebuild at send" checkbox on the mailing "proof and send" screen only affects the behavior of scheduled mailings, so now we only show it if you are scheduling a mailing.
• We added several useful text filters to the documentation. Thanks to Scott at MoveOn for the request!
• We standardized email address tracking for state targets so it's the same as with federal targets:
• Target.email is blank
• TargetContact exists and has email actionkit-contact@example.com only if a valid email exists for the target
• TargetContact can also be created/overridden by clients and we won't change that data (until the legislator changes)

9/14/2020¶

Recurring Donation Support in EveryAction Integration Beta

We've added support for recurring donations to our EveryAction sync. Contact support to join the beta today and help us test it out!

Pages Will Enforce If Postal/Region Are Marked Required

We've added code to allow you to require Postal and Region fields for international addresses. Previously we enforced Zip and State requirements but only for US addresses and we didn't provide a way to do the same for non-US addresses since there are countries that don't use postal codes. You can now set those fields required and they will be required for non-US users. We don't validate postal codes. We also added a "Required in US" mode for backwards compatibility with the old behavior of only enforcing zip/state requirements in the US.

Here's how it works:

• In the user-form-field customization interface, there are now two versions of the "Required" mode for the State/Region and Zip/Postal entries: "Required", and "Required in US".

• The "Required in US" mode matches the previous behavior of "Required": for US addresses, state and zip are required, but for international addresses region and postal are not.

• The "Required" mode makes the relevant fields required for both US and international addresses.

• The State/Region and Zip/Postal fields on all existing pages will show up in "Required in US" mode, and thus will maintain their previous behavior.

• However, if you would like to require a region name and/or a postal code for international addresses, you can switch the corresponding entry in the user-form-field customization interface to "Required."

8/19/20¶

Customize Event-Related Emails Without Editing Templates

We've added a new step to Event pages called "Custom Emails" that allow you to customize event emails like event approval, cancellation, and similar emails without needing to make changes to your templatesets.

The options available are dependent on the page type -- the dropdown above shows the custom emails associated with the Event Create page type. Select an email type and the subject and body will be pre-filled from your templateset.

Select a type, make your edits and users who create an event on this page only will get them. Your templateset remains the same. Read more about this exciting new feature.

Customizing your events emails is easier with this new feature, but so is making mistakes! Be sure to test if you make changes.

House of Commons of the Parliaments of the United Kingdom and Canada Available as Advocacy Targets

These bodies are now available as built-in advocacy targets. As with US state legislators, you won't see these target groups in your instance until you enable them. You can do this from Pages->Targets->International Targets.

Simply select the body, customize the name if you'd like and save. The target group will then be available for selection when you create a Letter, Petition, Call or Whipcount page.

Currently you can only add the full body as a target group -- in an upcoming release you'll be able to target subsets of these bodies.

We match users to their electoral constituency or riding based on their geocoded latitude-longitude. The more address info provided, the more accurate the match. We suggest at least including postal code in the user form. Please note -- you cannot currently make postal required. This will be fixed in the next release, if not sooner.

You can also deliver signatures to targets for whom we have email addresses (100% for Canada and 98% for the UK). CSVs and a PDF template with appropriate fields for international deliveries is another upcoming addition.

You can use Page Target snippets and direct the mailing to constituents by selecting the Target Group or picking a Division:

Salesforce

We continue to improve the Salesforce sync as well. This release we fixed a pair of SalesForce bugs that were using SF API calls by repeatedly sync'ing recurring donations, and by unnecessarily checking for missing donations. Thanks to Shawn at J Street for the reports.

We also added a 3 hour wait before we try again when any user fails to sync. Previously we only waited for new users.

Other

• By default, login_string tokens are good for 30 days, but you can also specify a TTL, in seconds, as an argument. An invalid TTL or a TTL longer than 30 days will by set to 30 days. Thanks to Ethan for the suggestion!
• The embed widget now generates the code you need to include the Recaptcha spam prevention, if you have the Recaptcha Enabled custom page field set to 'Enabled'.
• We fixed the Live Link Local Files template editing feature for Chrome that was broken by a recent Chrome release. Thanks to Aaron for Pollinis for flagging this!
• We've improved how we email some reports. This resolves a variety of issues, reported by Mark on behalf of UltraViolet, including the occasional failure to deliver the reports.
• There's a new filter for hidden in the Mailings Query Builder and Mailings Advanced Search so you can easily exclude these from your results.
• We fixed a problem that prevented mailings with certain emoji characters in their subjects from building successfully - thanks to Blue America Project for the report.
• Thanks for a report from Phil at ONE, we were able to find and fix a bug that sometimes hid the actual error when previewing a mailing with broken template code.
• We changed a couple of names to improve clarity:
• IP address checks: If an action taker's IP matches the block list, the spam check log will report: `Found in block list:`. If the IP matches the list of allowed IPs, the reason is `IP allowed`.
• Multiple currencies: "Use Account Switcher" is now "Display Currency Switcher" to make it clearer that this is for switching between international currencies when dealing with donations.

7/27/20¶

Virtual Events

The events system now has support for creating campaigns for events that will be held online, by phone, or in other "virtual" settings. Campaigns will continue to default to hosting only on-site in-person events, but you can change them to support only virtual events or a mix of both.

Virtual events can be organized either for a local area or on a global basis. Local virtual events show up on an event map, but don't list a specific street address, while global events don't appear on maps and only show up in event listings.

For both types of virtual events, hosts are prompted to specify the conference hosting platform instead of an event venue, and to provide attendees with connection or dial-in directions rather than driving directions.

These changes appear in the Original templateset and will be merged into your templates where possible. If your event templates are heavily customized, you will need to incorporate the relevant changes before you can use these new capabilities.

EveryAction Integration

This release includes the first version of our EveryAction integration, which ships users and one-time donations to EveryAction.

Like the SalesForce integration, reports control which users and donations are synced.

You can edit the field mappings to control what data is synced and where it appears in EveryAction.

Spam Check

The Honeypot spam check has been replaced with a more reliable check that uses the Akismet service. Action details including IP address, user agent, referer and more are evaluated by Akismet and the action gets an up/down on whether it's spam or not.

The Honeypot check has been disabled. The Akismet check has been enabled for clients that were using the Honeypot.

Spam checks can be configured from the CONFIG page.

Other

• For petitions with large numbers of signatures (>500k), attempts to deliver CSV files showed an error about not being able to generate PDFs. While PDFs are still limited, CSV files are not and we have changed the error to reflect this. Thanks to Leonard and Tara at Color of Change and Zoe from Middle Seat working for ActionPac for reporting.
• We fixed an unexpected error from the REST API for PATCH requests on certain page types. Thank you to Patrick Hensley with NRDC for reporting this to us.
• REST API searches using custom fields should work more intuitively now. Previously, using field__name=x&field__value=y in API searches could return records where one custom field had the name 'x' and a different custom field had the value 'y'. Now we return only records where custom field 'x' has value 'y'.
• REST API requests can now filter on action source. Thanks to Third Bear working for FCNL for this request and the one proceeding.

6/2/20¶

Release Notes

ActBlue by candidate breakdown

When recurring donations were broken out by candidate, ActionKit and ActBlue data could get out of sync if the amount per candidate was updated. To account for this, we've added columns to the core_actbluetransactiondetail table: amount, currency, amount_converted and candidate. Now, updates to recurring donation amount per candidate will be reflected in ActionKit. We'll be backfilling the data over the next few days. Thanks to a detailed explanation from Ethan at Third Bear, reporting on behalf of several clients.

QuickDonate

This release includes a couple more QuickDonate improvements:

• Fixed a bug that let staff log in as donors by following one-click links in mailings.
• Fixed a bug where the ActionKit form could briefly be visible after landing on a QuickDonate donation page.
• QuickDonate forms now use the default amount set for their ActionKit page.

Other

• We added a line to the User Donation History Page noting the mailing that prompted a donation. Thanks to Halley at Represent.us for the request!
  
• If you begin running a report, then navigate away or close the tab without emailing the report, we will stop the report since nobody would see the results.
• We corrected how recurring first payment date is computed for recurring orders with a start date in the future. This affects the display on the admin recurring start interface and snippets. We also changed the user update recurring_info.html template to use this method for First Payment, instead of the create date of the recurring order.
• You can now load event search results with a different templateset using {% verbatim %}&template_set={% endverbatim %}.
• We fixed an issue with event search by state name that was causing past events to display. Thanks to Lee @ Everytown for letting us know about this problem.
• We also fixed a bug with viewing events by year in the admin UI. Thanks to Jackie at Third Bear working for AOC for the report.
• Previously, the timed send validation report on the haiku/confirmation screen could sometimes fail if database replication was behind. That's been fixed, thanks to Nathan at Faithful America for flagging.

5/20/20¶

Release Notes

Fix for incorrect next_payment dates for Braintree recurring donations

We fixed an issue for Braintree recurring donations that were configured to use a plan billing on a fixed day of the month. These recurring donations had an incorrect start date, and would therefore return the wrong date for next_payment_date. Going forward, the recurring start date and computed next_payment_date should be correct.

After this release goes out, we will run a job to correct the recurring start date of any existing profiles affected by this issue over the next few days. Thanks for Chris from 350 for flagging the discrepancy.

Record of templateset changes

When we make changes to the Original templateset, we automatically apply those changes to your templatesets if we can. But if your templatesets are heavily customized or you're using our GitHub integration, we often can't apply those changes; you need to make them manually in order to get the latest bugfixes or features. To help you make these changes on your own, we've added a section to our documentation with every change we've made to the Original templateset since we re-released it in October 2016. Thanks to Suzi at 350 and Mark working for UV, among others, for the request.

Quick Donate

We're continuing work on supporting one-click donations using the combined EveryAction/BSD pool of saved credit cards, including adding an option you can use to customize the text of oneclick donation links. Pass a "text" parameter: {% verbatim %}{% quickdonate_buttons text="Chip in now:" %}{% endverbatim %}

Other

* You can now restrict event email targeting to users who are in the same (US) county as an event. You'll see a new "Same County Only" option on the mailing Targeting screen:

Checking this box will also check 'Same State Only'; unchecking 'Same State Only' will also uncheck 'Same County Only'. Thanks to Bianca from the Bernie campaign for the request.

* We now order tags by name alphabetically when you are selecting a tag for the mailing and selecting recipients by tag. This should help address a problem Dream Corps ran into with finding a "parent" tag when they had many "child" tags starting with the same letters.

* We fixed an issue where the Salesforce sync could fail when mapping to a Salesforce field of type Date. Thanks to Shawn@JStreet for flagging the issue.

* We fixed a bug where updates made to custom action field labels set in Customize Fields sometimes weren't visible on pages. Thanks to Virginia working for the Pressley campaign for reporting.

* We fixed a bug with erasing users where selecting the option to erase confirmation mailings errored if the user also had been sent other types of transactional mailings. Sandra at MoveOn helped us find this obscure one!

* The mailing snippets {% verbatim %}{{ donations.most_recent_all }} {% endverbatim %} and {% verbatim %}{{ donations.most_recent_date_all }}{% endverbatim %} (which show the most recent donation) now show a recurring donation's most recent payment, rather than when the recurring order was originally set up. Thanks for LJ from First Look for raising the issue.

* We've added snippets for a page's advocacy targets to the snippets menu for confirmation mailings. Thanks to Ben at JStreet and Robert at Demand Progress for the requests.

5/6/20¶

Release Notes

• We upgraded the version of jQuery used by ActionKit admin pages. Note that your templatesets are not impacted by this change.
• We optimized the donation-related queries generated by the query builder. Many newly-built donations queries should run even more quickly than previously.
• Changing a target group did not force rebuilds for mailings that target constituents of the group. We fixed this! Thanks to Michael at First Look for reporting this issue.
• If you tried to stop an automatic subject line test, but the test mailing had already finished sending, the winning subject would be sent anyway. We have now fixed this so that clicking stop on a test mailing always stops the test. Thanks to Keith at PCCC for the report.
• We added an option to delete Salesforce mappings when merging users. This prevents merged users from creating duplicate contacts in Salesforce.
• When building a donations query report, you can now display or filter on the user's federal or state legislative district.
  
  Thanks to Shawn at JStreet for the requesting both of these changes.

4/20/20¶

Release Notes

Event permissions change: You may need to adjust staff permissions today

We've separated Events permissions completely from Pages permissions, so if you have staff members that should only have access to Events, you no longer need to give them Pages permissions for them to be able to edit their events.

Similarly, if you have staff who manage pages but you don't want them to be able to manage events, you can give them only Pages permissions and they will no longer be able to edit or manage events.

Staff-users permission removed

To create new staff users and assign permissions, you need to be a superuser.

Custom user fields have a timestamp and action

We've added a field for the last time a custom user field has been updated, as well as the associated action, if there is one.

You can view these new fields in the core_userfield table as shown below (remember, the parent_id is the same as the user_id):

Thanks to Jase at 350 for requesting this feature!

Reporting replica delay notification

When you run a report from the ActionKit admin, it is run against our secondary ("replica") database for performance reasons. Occasionally, the replica falls behind. When this happens, recent actions don't show up in your reports until it catches up to the primary database.

Your data is safe and properly recorded, but it looks like data is missing, because there's no recent activity. That can be confusing and scary!

Now, we'll show you the time your report ran:

Other

• If you have auto excludes set up, and your mailing's auto exclude date does not match its local time zone timed send date, we'll show a warning.
• An old Salesforce sync failure was sometimes reported on the User History page, even if there was a more recent successful sync. This has been fixed. Thanks to Shawn at J Street for flagging the outdated message.
• We already check for duplicates when syncing donations to Salesforce. With this release, we've added a similar check for donations coming from Salesforce. If a transaction/recurring donation is received from SF that already exists in AK, a mapping is added but no new donations created in AK. Thanks to Chris at 350 for the report that prompted this.
• We fixed a problem where if you tried to edit the details of a past event, you'd get an error on the form even though your changes would be saved. Now you can edit past events as needed.
• We got rid of the confusing custom target group "US Governors" that we added years ago as an example, since the data was neither complete nor correct. We also eliminated related duplicates. Thanks to Conen at Progress Now for reporting the dupes.
• We improved the performance of the mailing tab for folks with lots of mailings. If you found these pages slow in previous releases, give them another whirl!
• We fixed a bug with A/B tests that caused optimization to stop working if it ran into stats that it didn't expect (like if your page had more actions than views). Thanks to Nathan at Faithful America for finding this one!
• We added a note to the Communicating with Congress section of the user guide clarifying that it may take up to an hour for signatures to be delivered to the CWC system.
• We've improved the error messages for donors whose donations fail due to AVS errors from Braintree. We've mapped error codes to new messages and added specific message about missing street or postal code.

3/31/20¶

Release Notes

We're expanding the beta integration with FastAction to include one-time donations on ActionKit donation pages. The FastAction/QuickDonate pool has millions of cookie-based saved profiles, and once a logged-in donor reaches your donation page, they can quickly donate without having to enter their personal or payment information.

On pages that use a FastAction account, the usual user form is replaced with an embedded QuickDonate form which can be styled to match the rest of your page.

We plan to add support for recurring donations in the future.

As part of the release we'll update the Original templateset and attempt to patch your customized templatesets. If we're not able to apply the two patches, you can apply them yourself:

Before the opening of the "content" block:

{% block body_extra_classes }}
{% if page.payment_processor_information.is_quickdonate %}
actionkit-donate-qd
{% endif %}
{{ block.super }}
{{ endblock }}

After the end of the "content" block:

{% block below_form }}
{% if page.payment_processor_information.is_quickdonate }}
{% load_quickdonate %}
{% endif %}
{% block.super %}
{% endblock %}


If you’re interested in beta testing, please get in touch!

Use custom event fields to target mailings and filter using {% templatetag openblock %} withevents {% templatetag closeblock %}

You can now limit the events included in your mailing (using the “New” snippets) and target your mailings by the value in a custom event field. You can also limit the events returned using "withevents" and a new parameter.

You might use this if you have an event campaign that includes several types of events, differentiated by custom fields, like house party or rally. Until now, mailing users about only one of these types of events has been difficult, requiring a combination of custom targeting queries and mailing template code.

Now the mailing targeting screen includes an option under "event campaigns" that allows you to select custom fields used by your events and specify the values you want to match in those fields.

To match any one of several values, separate them with a comma or semicolon.

Your selection here works with the “New” snippets under “Events” just like other event campaigns targeting criteria. The snippets will only display events that match the selections you make in this section.

This capability is also available for mailings which use the {% withevents %} tag. Specify a custom event field by including a parameter like "rally" as event_field.activity to only match events whose activity custom field is set to rally. For example:

{% withevents with user as nearby_user 'my_cool_event_campaign' as campaign 30 as radius 1 as limit 'rally' as event_field.activity %}

To match any of several values, use the format "rally;march" as event_field.activity.

Thanks to the multiple clients who have articulated the use case for this feature, particularly Kenneth at Middle Seat working for Beto and several other clients.

View all events

A new link on the event campaign page, "All events for all campaigns", can be used to view all events across all campaigns. Again, thanks to Kenneth for suggesting!

Easy access to past and upcoming events for host

User account tools now includes a section with a user's Upcoming Events and Past Events, with links to their host tools page or attendee tools page as appropriate. Thanks to Jon for the Bernie campaign, among others, for the suggestion.

More Events

• If a report takes an event_id parameter, then full event details will be available via an event object, e.g. {% event.starts_at_utc %}, as seen with user_id and {% user %}
• Line breaks in the event description, note to attendees, or directions will now be displayed to the end user, instead of being rudely ignored. This applies to the Event Details page, the Event Signup page, the Attendee Tools page, and the Host Tools page. If you do not see these changes, you may need to edit your templateset's wrapper.html to add the following CSS:
  .ak-event-description, .ak-event-note-to-attendees, .ak-event-directions { white-space: pre-line; }
• The Original templateset better supports event campaigns that don't require host confirmation. For example, the text displayed to hosts after they’ve created an event and in their after action confirmation email has conditionals to account for this setting. We tried to apply these changes to your templatesets as well, but if you've customized yours heavily you may need to make these changes manually. See event_email_created.html and event_created.html in the Original templateset for the code to copy.
• Also, if your event campaign requires hosts to confirm their email but your Event Create page doesn't have a confirmation email set up, we'll remind you to set it up.

Mailings

• Proof mailings now show the expected send count in the subject line, just like final mailing notices. Thanks to Michael at the Bernie campaign for the request.
• We fixed a grammatical error and clarified some language around when you can pick a winning email or subject line. Thanks to Sue Anne at MomsRising for the report.

Other

• If one of your users marked an email as spam, they wouldn't be able to receive password reset emails, donation confirmation emails, or event host confirmation emails. Now they can. Thanks to Marie at NRDC for the most recent report of this problem.
• We fixed an issue where recurring donation updates at Braintree were failing to pass address information for AVS fraud checks. Thanks to Marguerite at First Look for letting us know about the issue.
• The immediate delivery subject is back where it should be, above the immediate delivery body on the Delivery screen; thanks to Joe at Everytown for the report.
• Previously, it was difficult to turn off Communicating with Congress delivery even if you’d removed the US House as a target group for your page. Now we turn it off automatically in that case. Please note you'll still need to remove any user fields on the Edit Content screen that were added for CWC delivery (like prefix and street address ) if you don’t want them to be required.Thanks to Jessie at FCNL for reporting the problem
• When setting up action notifications, you can now use commas, semicolons, or spaces to separate your To email addresses. Thanks to Beca from Everytown for the request.
• More emojis! We added support for emoji in confirmation mailings, tell-a-friend emails, action notifications, and social sharing titles/descriptions.

3/5/20¶

Release Notes

Events

Event Date Criteria In Mail Targeting

Clients with event campaigns that last for multiple weeks or months can now use date criteria on the mailing targeting screen to limit the audience to users near events in a certain time period.

For example, if you have events happening every weekend, you can easily target users who live within a few miles of next weekend's events only.

You'll find these options on the mailing targeting screen when you select event campaigns.

Those date options are also passed along internally as default values for the {% templatetag openblock %} withevents {% templatetag closeblock%} tag if you're using that mechanism.

Thanks to several clients for requesting this feature, including Jase for DFA, Chris and Scott at MoveOn, and Michael and Robin at the Bernie campaign.

Custom Dashboard Reports On Event Screens

We've added support for two new special reports you can use to display event-related information in the admin interface.

If you create a dashboard report named campaign_dash the results will be displayed on the Campaign Dashboard screen. This report receives {% templatetag openvariable %} campaign_id {% templatetag closevariable %} as a parameter.

Similarly, you can create a dashboard report named event_dash to be displayed on individual event detail screens, using the current event's {% templatetag openvariable %} campaign_name {% templatetag closevariable %} and {% templatetag openvariable %} event_id {% templatetag closevariable %} as parameters.

These join the pre-existing event_minidash which could already be used for a compact display of at-a-glance stats on event list screens in the admin UI.

All of these reports are standard dashboard reports that can be used to display any event related details. If you haven't taken the time to customize your dashboards, now is a good time and it's easier than you might think! Check out this video on how to create dashboard reports.

Extended Emoji Support For Event Fields

While ActionKit's Unicode support means that it generally supports characters from all languages, there are some fields which don't yet support so-called "four-byte" character codes used to record some extended emojis.

We've recently added support for these characters to several event fields, specifically the public description, "note to attendees," directions, and internal staff notes fields.

Blocking Event Creation

If you want to stop new events from being submitted for your event campaign, you can accomplish this by hiding its Event Creation page with a few small changes to your templateset.

Previously, hiding the Event Creation page would prevent hosts from viewing or changing existing events, but ActionKit can now distinguish between creating new events and editing existing ones. This change also applies to moderators or staff users acting as an event host.

We've attempted to patch existing templatesets, so you might find that hosts and staff users are now able to edit events when the Event Creation page is hidden. But, if you have customized your event templates, it's likely that you will need to edit your templates. If this is the case, make sure that your templateset reflects the Original templateset in its use of host_akid in the event_host_tools.html template and mod_akid in the event_moderate_tools.html template.

Hidden Event Pages

The Event Campaign Dashboard previously showed a blank row if you created an event page but then later hid it; we now show the hidden event pages so you can review them and make them visible again if needed.

Permissions for Event Pages

We've added permissions to the Events - Manage plus Campaigns group so that staff users can edit, hide, copy, and create event pages and campaigns with these permissions alone. You don't need the Pages permissions to do this anymore.

Fast Import for Custom User Fields

If you regularly import information about existing users as custom user fields, you'll love the new fast upload option!

Import pages have a new checkbox labeled "fast custom user-field upload."

As indicated, this option works if your upload only contains a user identifier and one or more custom user fields and only includes existing users. New users are not created; if your file includes new users those rows will fail and you'll be able to download a CSV of the failed rows. If your file includes other columns we will fall back to a standard import, unless you specify that we should skip the extra columns.

While the exact difference in performance will vary from case to case, it is generally five to ten times faster than normal imports.

This increase in speed is a result of bypassing a number of steps which are included in the normal upload procedure: no actions will be recorded, the user's updated_at timestamp is not modified, and no subscription changes are processed.

If you use this feature on a regular basis, there's a new option in the "Configure ActionKit" screen that allows superusers to turn this on by default.

The API also supports Fast Uploads with the user_fields_only parameter. Read more here.

Salesforce Settings History

When you update the Salesforce Global Settings screen, your changes are recorded and can be reviewed by clicking the History link in the top right corner of that screen. That log can be useful for pinning down when changes were made and identifying which member of your team is responsible.

Mailing Volume Warning

Internet service providers tend to view sudden spikes in mailing volume as indications of spam. To help avoid deliverability problems, we'll now display a warning if you target a mailing to send to a much larger audience than is usual for your instance. That warning encourages you to split the mailing up into multiple smaller mailings, spread out over several days, to help prevent damage to your sender reputation.

Assorted Fixes And Improvements

Trailing Slashes in Event URLs

If the Host Tools page's URL didn't end with a slash, the Edit Event Details and Cancel Event links would break. Now all the links work whether or not the URL ends with a slash. (If you still see broken links on your Host Tools page, you will need to update your templateset. See event_host_tools.html in the Original templateset for an example.)

We also fixed this problem for the Cancel Signup link on the Attendee Tools page. (If you still get a broken link when attempting to cancel your signup, you will need to update your templateset. See event_attendee_tools.html in the Original templateset for an example.)

Editing Targeting Reports While Mailings Are Sending

There have occasionally been problems in the past when someone edited and saved a query report just as a mailing that uses that report for targeting was in the middle of rebuilding its audience before sending. We've done some work to make this more robust and hopefully put the issue to rest. Thanks to Mitchell at Mothership for Turnout for reporting the details of a recent occurrence.

Fixed Links For Custom Field Definitions

If you created a custom field definition whose name contained an underscore, some links in the admin interface led to "not found" errors. Thanks to Benjy at Zazim and David at ONE for helping us track down which combination of circumstances triggered the problem.

Transactional Mailings Included In User Action History

When you click on a row in the admin screen for a user's action history, you'll see a summary of the confirmation mailing for that action. That display now also includes any other transactional mailings, such as admin notification emails and "in honor of" mailings. Thanks to Marie at NRDC for asking the question that inspired this feature.

ActBlue Refcodes Consistently Recognized As Action Sources

We fixed an issue with the ActBlue integration where certain specially-formatted refcodes were not recorded in the action source. Thanks to Ethan at Third Bear for PCCC for reporting.

Debugging Confirmation Messages With requires_value And Staff Account

If you use the {% templatetag openblock %} requires_value {% templatetag closeblock%} snippet in an after-action email, then sign the page with a staff user that would fail that check, you'll now get an error telling you that staff user did not have the required value, to help you in debugging your confirmation emails. Thanks to Ethan at Third Bear for Represent.us for reporting.

2/12/20¶

One Click Donations

We are excited to announce native one-click donation support, thanks to our beta integration with FastAction. ActionKit clients can now can include instant donate links in ActionKit mailings and take advantage of the millions of saved payment credentials in the combined EveryAction and EA Digital Tools (formerly Blue State Tools) pool. When clicking an instant donate link recipients are charged immediately, helping you raise more money faster.

Snippets in the mailer allow you to insert a stack of suggested asks:

You can edit the appearance of the buttons or provide a single link:

If you're interested in helping to beta test this feature, please get in touch!

With the release of this feature, we're disabling Remember Me and our old Instant Donate system. If you have any pages set up with Remember Me, don't worry -- that option won't show up anymore but your pages will still work. If you'd like to participate in the new hotness, check out Cross-site Prefill which uses EveryAction's pool of millions of cookie-based saved profiles.

Events

Event hosts don't have to confirm their emails

You can now turn off the requirement that event hosts confirm their email address on the Campaign Settings page. (It's still on by default).

If you uncheck this, you need to consider how the rest of the event creation flow will work for volunteer hosts. For example, you may still want to send an after action confirmation email to host so they have a link to their host tools. An example of this has been added to the documentation.

Also, remember, the default thank you page after event creation tells hosts to check their email to confirm their event. You will want to edit the event_created.html template if you aren't sending a confirmation email.

End user event search by state

When your users are searching for an event near them, if they type in a state abbreviation or name instead of city or zip, we'll display all events in the state.

Donations Query Builder Bug Fixes

• We no longer generate incorrectly high results for payment "totals" display columns for recurring orders when you use them in combination with the "was paid" filter criteria. Thanks to Mais at Syria Campaign for reporting the issue.
• If you used the "Users > Number of Payments" or "Users > Sum Of Payments" items and then supplied a date range, the date criteria were previously applied incorrectly.Thanks to Marguerite at First Look for letting us know about the problem.
• Amount of Highest Payment filter and the User Donation History page erroneously included recurring transactions that had been refunded. Thanks to Bianca at the Bernie campaign for reporting.

Salesforce Sync Improvements

• Salesforce-origin opportunities synced into ActionKit only had a date in the created_at field but the field in ActionKit requires a time. Previously this defaulted to midnight, causing issues with reports and the Donation History page showing the incorrect date after timezone conversion. Now we use noon instead of midnight, so your reports and the Donation History page will display the correct date in almost all cases.
• When a recurring order that originated in Salesforce is synced to ActionKit, we now create a row in core_transaction with the "recurring_order_create" type. This fixed a problem where some reports, like the Page: Recurring Donations Created (used in the Page Drilldown Dashboard), would not show these recurring donations. We've also retroactively fixed this for all affected orders. Thanks to Michael at Firstlook for flagging this and the one above.
• We now accommodate a corner case where the sync would fail if a donation didn't have an associated payment. Thanks to J Street for finding this one!

Other

• Signatures are NOT delivered to federal legislators via immediate delivery, so if your page ONLY targets federal legislators, immediate delivery is no longer displayed as an option. If you aren't targeting the US House, Communicating with Congress is not displayed. Thanks to Emily at the Justice Collaborative for the bug report and inspiration.

• Previously, if you used the code or plain editor modes to add a <meta> tag to one of your HTML fields, and then toggled into the visual editor mode, your meta tag would be removed. Our WYSIWYG had strong opinions about those tags only appearing in the <head> section of the page, which is technically correct, but in practice most browsers allow these tags to in the body, so we have updated the visual editor to be more flexible. Thanks to Mitchell @ Mothership for Progressive Turnout for pointing this out and clearly articulating the case for changing this.
• When browsing the admin interface in recent versions of Chrome, many select boxes, aka drop-down fields, had two sets of arrow icons near their right edge, as Chrome recently changed which experimental CSS attributes they supported. We now supply both the Mozilla and WebKit versions of these attributes and these fields have returned to their normal appearance. Thanks to Jase at 350 for reporting!
• We're still killing those erroneous prompts about losing data when you save your changes. Aaron for Pollinis found this one when editing and then saving the order of custom page fields. Please help us stop this insidious and irritating error! If you see something, say something.

1/8/20¶

Timed Sends

• Timed Sends and Test Groups have made up and will now work together. Thanks to Nathan at Faithful America and Annie at Indivisible for letting us know. You'll see a rough count and send time on the haiku screen and the Test Group screen includes a note about the timed send:

  

• On the other hand, Rebuild at Send is not available with Timed Sends. The targeting set only rebuilds when the targeting changes or a rebuild is requested by a staff member. This was not clear in the UI so we will now remove the Rebuild checkbox if you've made the mailing a Timed Send (either with a merge query or by checking 'Local Time' on the Proof and Send screen). If you change the mailing back to a standard send, the 'Rebuild' checkbox reappears. Thanks to Vojtek at SumOfUs for reporting.

• Max emails/secondMax emails/second no longer displays as an option for a Timed Send mailing.

• We've improved the notifications you'll receive associated with a Timed Send mailing. You'll get an email letting you know that your Timed Send messages are being built and an email notifying you once all message have been sent.

• And, we've made some clarifications in the admin UI, like adding "Timed Send" under the mailing subject on the Sent mailings list and starting a Timed Send mailing on the Scheduled list with the status changing from Generating to Waiting to Sending before the mailing moves to the Sent list once all messages are out.

New Optional Email Notification When Event Details Change

We've added a new email that will be sent to hosts and attendees of a particular event when certain details change (e.g. new location), if the host checks a box on the Edit Event page:

By default, the email looks like:

The text for this email lives in the event_email_details_changed.html template and can be edited there.

To enable use of this email, a small change needs to be made to your event_create.html template. We've patched this to templatesets that are still very similar to Original but most of your sets are customized so you'll need to apply the change described in the documentation manually.

Thank you to Tibet at Demand Progress and Hannah from Bernie for the request!

Other

• On the after-action notification creation screen, you'll see a list of pages that have the notification enabled. Thanks to Jase at 350 for the request.
• We fixed a bug that caused merge queries to fail if they had SQL like:
  
  SELECT id AS "user_id"
-- , "foo" AS "foo"
FROM core_user
  
  That works as a report and with this release, is also recognized by merge queries. Thanks to Sean, Robin, and Joel at Bernie for helping us find this one!
• The HTML code generated for embedding an ActionKit page on your website now automatically includes support for source codes. When you create a new embedded page from the Embed AJAX Signup screen then include a source parameter in your URL, the action recorded will include the source. Thanks to Atiya at 350 for the suggestion.
• Clicking the submit button on the "upload user data" form multiple times could previously cause multiple upload jobs to be fired off in parallel. This change disables the submit button for a few seconds after it is clicked. Thanks to Sam at ActBlue for bringing this problem to our attention.
• Type-to-search is now available for four pull-down menu fields on the mailing compose screen: from line, email wrapper, merge query, and merge file.
• If you used the query builder to generate a report that included currency values, and displayed the results using a Google Table view, then clicked the column headers to sort the results, the contents sorted in alphabetical order ($100, $2, $30). We've changed this so they now show up in numeric order ($2, $30, $100), which is almost always what you actually intended. Thanks to Kenneth working for AOC for flagging the issue.
• We fixed a bug where users in some parts of Arizona were getting the wrong timezone assigned. Thanks to Nicole from National Nurses United for reporting.
• When using the query builder, timestamps displayed in "Numeric Date" format were showing up in the "Abbreviated" format -- and if you asked for the "Abbreviated" format you actually got the "Written Date" format. This has now been sorted out. Thanks to Andy at Yang 2020 for the report.

11/6/19¶

Events Improvements

When linking attendees to an event using the campaign name instead of a page name, we now always display a page that matches the language used to create the event. Previously some links defaulted to English.

We also added an option to find events by federal legislative district to the Advanced Search on the Event Campaign Dashboard.

This change makes it easier to assign turf to moderators based on CD using the approach outlined in our blog post on this topic.

ActBlue one time donations that become recurring are recorded as such

We've accounted for a case where ActBlue converts a one-time donation to monthly so we can correctly assign all related donations to a recurring profile in ActionKit. This will happen automagically in future. After this release we will clean up missed donations in this category as well. Thanks to Adam at MoveOn and Lee at Everytown for the examples.

When no result is the best result

If you've got reports that intentionally return an empty string if all is well, you may have noticed that these reports never seem to complete. Now they do! And why would you write such a report? Our master of the admin UI dashboard, Shannon Turner, created such a report to include in UltraViolet's pre-flight checklist mailing dashboard, which you may have seen at ClientCon. The report would return nothing if everything was in order and an error if something was missing. Thanks to Shannon for finding the bug as a client and fixing it as a Walker!

No more creating a second report with the info you need to make sure your mailer targeting report is finding the right users.

Mailer targeting queries can now return additional columns, after the user_id column. The additional columns are ignored by the mailer but they make the report easier to spot-check and reusable for a merge query or regular report.

Error messages about emojis with emojis!

If an end user tried to submit unsupported emojis on one of your forms, they would see:

"Sorry, we're having trouble handling your request at the moment. Please try again in a few minutes."

We've changed this message to accurately describe the problem, which will not be fixed by waiting a few minutes. Now they'll see something like this:

And it's translateable too:

Thanks to Maya at Indivisible for flagging the unclear message.

Better international geocoding

We completed the last step in our improvements to geo-coding for international users. We've re-geocoded all existing international users with an address and turned on Bing as the fallback to Open Cage for new or changed international geocoding.

Other

• We've improved the error messages you see if you create a dashboard report that fails. Instead of “Report failed”, we’ll display a more informative error if possible.
• We now check for daily/weekly cached merge queries that are about to expire and rebuild them for recent mailings that use them, so that proofs and targeting builds don't have to wait on these to run. Previously we only did this for cached targeting queries. Thanks to Tim for Bernie for the report.
• With this release, only superusers or staff with the Users permissions can merge user records.
• Previously some mailings that were stopped or died did not have the finished_at field set; now they will. Thanks to Brandon at Mercy Corps for the report.
• We've changed the ActionKit ID assigned to recurring payments in Salesforce that originated outside of ActionKit. Going forward, these Opportunities will have an ActionKit ID of "RecurringPayment-[transaction id]". The value we were using previously would sometimes conflict with other ActionKit IDs, causing the sync to fail for these donations. After this release we'll clean up the conflicting IDs for old donations as well. Thanks to Shawn at J Street for discovering the failures.
• We fixed a small error that led to all actions in the spam check log having a minutes value of :09. Thanks Jase at 350 for observing and reporting the issue!
• We added retries to compensate for a rare infrastructure failure that could cause mailings to die. Thanks to Nathan at Faithful America for the report that helped us identify this issue.

10/10/19¶

"Save as Report" to Add Query Reports

On the Reports tab, we combined the old "Run Query" and "Add Query" menus. Click "New Query" and select a query type, then choose displays/filters or write SQL, and (if you want) run it to test. If you want to save your new creation, click "Save as Report" (at the top of the page or next to the submit button) to assign a name, etc. and save it.

Passwordless Login for Event Hosts

We've updated the templates for emails to event hosts to always include a login string and not require the host to set a password before using their tools.

If you've edited event email templates in your templateset, you may not receive this change automatically. The key change is to add {% verbatim %}&i={{ user|login_string }}&l=1{% endverbatim %} to links to host tools. You can also look at the Original templateset, which has related changes like text warning hosts not to share their personalized links.

Upload Volunteer Moderators for Events

In addition to being able to upload events and attendees, you can now upload a CSV or TSV file of volunteer moderators to review events. You'll see "Upload Volunteers" in the list of event pages on the Campaign Settings screen:

More Events Improvements

• You can now base your event email templates on those of another templateset with code like {% verbatim %}{% extends "Other templateset/event_email_created.html" %}{% endverbatim %}. Thanks to Joe at Everytown and Matthew at 350 for reporting that this didn't work before.
• In mailings to recruit event attendees, you can now use the code {% verbatim %}{% for event in events|dictsort:"least_full" %}{% endverbatim %} to sort the events with the most open slots to the top. Thanks to Bianca at the Bernie Sanders campaign for suggesting.
• The event mini-dashboard report is now available on the Event Details screen as well as in the event list. Mini dashboards let you embed custom reports in certain parts of the admin user interface. You can learn more about mini-dashboards in the docs.
• We've revised the event merge interface so it's clearer when we will send a message to hosts or attendees. Thanks to Rachel at 350 for bringing the issue to our attention.
• We now handle event submissions or uploads with long US state names, like "Washington" instead of "WA." Thanks to Kenneth working for the ACLU's PeoplePower campaign for finding this issue.

Salesforce Sync Improvements

We now keep track of whether ActionKit user IDs and emails match between users and mapped Salesforce contacts. The sync relies on these fields matching, and contact updates or donations may not flow when they do not match. The user profile page will warn when there's a mismatched ID or email for a mapped contact. A new report, "Salesforce users with mismatched emails", helps identify users with mappings that match on ID but not email.

We've also normalized how we choose a contact when syncing a user for the first time, when multiple contacts have matching email. Now, the contact with the largest number of donations is selected.

Separately, we've made some fixes to donation sync. We now correctly import recurring payments as failed if marked Closed Lost in Salesforce, thanks to a report from Marguerite at First Look Media. We also better handle donations or recurring payments deleted on the Salesforce side, thanks to a report from Shawn at J Street.

Mailing Targeting Speed Details

You can now see how long each query in your mailing's targeting took to run, to help understand what's causing slow queries. On the Proof and Send screen, you'll now see a "View SQL and Query Times" link next to the Targeting section header:

You'll see the times in italics underneath each query:

Currently, run times for cached query reports aren't available in this view. We hope to add them at some point in the future. However, you can now see how recently a cached query was run in the Targeting section on the Proof and Send screen:

Everything Else

• When composing a mailing, you can now preview a specific user's message by entering their email address or their ID. Thanks most recently to Jase @ 350 for the request:
  
• We've fixed an issue where HTML editors in the admin could end up stuck in plain-text mode. Thanks to Keith at PCCC for reporting.
• We've fixed an error that could cause petition delivery previews to incorrectly fail if the petition had test signatures more than a week old. Thanks to Lucia Martinez at FreePress and Irma Corado at Indivisible for reporting.
• The query builder now produces faster SQL for queries involving multilingual campaigns. Thanks to Julia at 350 for reporting the performance issue.
• The new ActBlue webhook integration will avoid resubscribing users who were unsubscribed since the date of their donation. Thanks to Eric for the Inslee Campaign for reporting the issue.
• The new ActBlue webhook integration will now correctly back-date refunds when importing old data.
• We've corrected a rare situation where a user submitting a PayPal-enabled donation form twice could result in a duplicate gift. Thanks to Brandon at MercyCorps and Marie at NRDC for their reports.

9/10/19¶

Prefilling: get more actions, do more good!

With this release, you can enable prefilling on your ActionKit pages using EveryAction's Action Profiles -- a pool of millions of cookie-based saved profiles from users who have previously submitted an action on EveryAction. Enabling this feature can boost your conversion rates from Facebook, your homepage, or other places users can't be recognized by their AKID. If you enable this feature, your users' data will be saved to the shared profile pool and will be prefilled on other organizations' forms.

Contact information, occupation and employer, and several custom fields that are built-in in EveryAction will be available for prefill (if the user has submitted values for them). No payment information is prefilled. This isn't a one-click donation feature, but that is coming in the future! Read the prefill section of the manual to see what fields are available and to read more about how this works.

Turn on this feature by following the "Prefill settings" link on the Pages Tab.

Improved UI for Sending to Your Users At a Specific Local Time

We've made a bunch of changes to offer you more choices and clarify what's happening when you choose the option to schedule a mailing to send to your targeted users at a certain local time. Specifically:

• For users whose send time has passed, you can choose: either send the next day at 9 a.m. or send immediately.
• The haiku screen has a summary of the expected send time.
• The stopwatch icon indicates timed sends throughout the UI.
• The mailing dash now says "Generating" during the initial send job, then "Waiting" while no mail has been sent, and then "Sending" once delivery has actually started.
• The send time calculations are now based on mailing send time, not the current time -- the mailings won't look artificially slow.

Thanks to Courage Campaign, FCNL, Indivisible, PFAW, PCCC, and more who made suggestions!

Events

Merging Events: You can now combine two events into one -- for example, if a host accidentally created a duplicate event or you only want one event in each city. Hosts and attendees from either event are all added to the event you select as final and all links to the old, merged event redirect to the final event. The merge link is available on the event detail page (reached by clicking Manage for a specific event from the list of events in any event campaign) and brings you to a screen in which you can select the second event and choose which pieces of information will be retained from each event.

Thanks to Everytown, the Beto campaign, and MoveOn, among others, for the use cases.

Multilingual events: When managing events, the Act as Host link now respects the language the event was created in rather than always defaulting to English. Thanks to Rachel at 350 for pointing out the issue!

Mailer

• Tags starting with special characters are once again findable through auto-complete in the mailer. Thanks to Nabil at Sum Of Us for pointing out the problem. (Also, check out A Tagging System that Works for why tags starting with special characters might be awesome for your organization.)
• The parent mailing of a recurring series (the one you can't edit or send) no longer shows the count and targeting rebuild date -- we never rebuild the targeting sets for the parent. Thanks to Scott at MoveOn for flagging the issue.
• Choosing a winning subject line for a mailing that is part of an A/B test group now correctly excludes all mailings from the group when sending the winner. Previously this worked correctly for choosing a winning mailing but not for choosing a winning subject. Thanks to Jay from DFA.
• If you manually selected a winner for an automatic subject line test, a bug showed the automatic full send still running due to a UI error; it wouldn't have actually sent. You won't see that phantom send anymore, thanks to a report from Tara at Win Without War. Go Wolverines!
• A new variable is available in the mailer: {%verbatim%}{{ recurring_schedule_id }}{% endverbatim%}. You can append it to links to, for example, keep track of welcome series' performance in your analytics tool. Thanks to Jake Holland for the request.
• Check out the documentation for an updated list of donation snippets available in the mailer.
• The mailing preview on the compose screen now shows the preview text below the subject line. Thanks David at ONE for suggesting.
  

Templatesets and Developer Resources

• When you go to preview an edited template, we'll save your changes before loading your preview so you don't need to remember to save the draft first.
• The staff user permission set "Pages plus Templatesets" now includes the ability to set up Github connections and manage custom templateset fields. Previously only superusers or those with All Models permissions could do this. Thanks to Scott at MoveOn for the idea!
• We added more details on how to use {%verbatim%}{% log_context %}{% endverbatim %} for ActionKit development. Keep in mind {%verbatim%}{% log_context %}{% endverbatim%} is most useful when trying to determine what snippets are available to use on a page or mailing, and is not a key-value store of all of the data. Thanks to Jase at 350 for asking for more info!
• ActionKit has a safety in place to keep you from deleting built-in templates from your templateset. Previously, if you tried to do this from Github, the attempt silently failed. Now we show a notification on the templateset page and a log entry on the job details screen. Thanks to Sky at MoveOn.

Salesforce

• The Salesforce mapping validator now checks built-in fields like Transaction ID to make sure the type and allowed length are appropriate.
• Salesforce mapping now shows a section with the fields that are required and not configurable.
• Partial refunds made in ActionKit will now sync to Salesforce as written off payments.

Everything Else

• The witch is dead! In this case, the witch is the core_orderrecurring.occurences field. If you've asked about it previously (and we said, "oops ignore that dumb field because whatever it says is wrong"), you'll be happy to know we just got rid of the dumb field. A few of you had included this in a report -- we've removed it since it was just telling you lies.
• On the Pages and Reports tabs, accidental double-clicks will no longer cause the page or report to save twice in parallel. This will avoid the same report running twice and avoid duplicate form fields being created during user form customization when you create a page. Reported by Irma at Indivisible -- thanks!
• You can now filter mailings and users by the year and month they were created, as you can do for Pages. Thanks Nikki at ONE for the request.
• Report parameters can now skip the quotes! Use the syntax ORDER BY ccu.page_id LIMIT {% verbatim %}{% sql_unquoted limit %}{% endverbatim %} to enter a number that's not in quotes. Be careful with using {% verbatim %}sql_unquoted {% endverbatim %}-- this could be used an attack vector if an attacker can control the parameter values.
• The schedule field on the proof and send screen doesn't have autocomplete anymore so you can always see the calendar picker. Thanks to Keith at PCCC for the report.

7/29/19¶

7/10/19¶

Mailings¶

Check a box to send your mailing to users at a specific time in their local time zone.¶

The timed sends feature now includes a UI for sending to users at their local time. To schedule a mailing for each user's local time click "Schedule for Later" and then check "Send to each targeted user at the time selected in their local time zone." You can still use merge queries for other implementations. Thanks to ClientCon participants for your feedback!

Limit the number of users a staff member can email with the new Limited Send permission.¶

We’ve added a setting to the CONFIG screen that you can use to define a ‘limited send’ permission. By default, the limit is set to 5 percent of your list, but you can edit this number.

The setting is used by the new Limited Send permission that you’ll see on the Change User screen. Assign this to any staff member and they can only send to the percentage of your list defined in the Mailer Settings. Staff users with pre-existing send permissions can still send to your full list.

More mailer improvements:¶

• The new {{ event.state_name }} snippet returns the full state name, in addition to the pre-existing {{ event.state }} that provides the state's two-letter abbreviation.
• The "Stop jobs" feature on the Mailings tab, normally used to stop slow mailing rebuilds, would previously also kill scheduled mailings that were preparing to send. Scheduled mailings preparing to send will now be left alone, and we've made it possible to stop individual mailing rebuild jobs.

• Extended run time for cached merge queries. When you define a merge query report, you may want to set it to refresh hourly, daily, or weekly to avoid running a slow report at send time. Previously, cached merge query reports only had 30 minutes to finish. We've extended that to 2 hours.

Thanks to Michael, Kendall and Robin from the Bernie campaign for flagging the three issues above.

• We improved mailing targeting based on location radius so it uses lat/lon rather than location code. That matches how we target events and improves accuracy for users with street addresses.
• An empty "Also Include" section in mailing targeting was inadvertently expanding targeting to all users. That's been resolved. Thanks to Gabriel at Majority Action and Nathan at J Street for the reports!
• We adjusted the way we handle default list exclusions in mailer targeting to protect against an edge case where the default exclude was skipped. Thanks to Jase at 350 for the report.

6/12/19¶

• You can now include past_due recurring donations in the query builder, thanks to a report from Marie at NRDC!
• On the Compare Mailings Report, we've added a separate column for selecting the winner, which is hopefully clearer than selecting the winning subject. In a future release, we'll also make this change on the the Individual Mailing Report. Thanks to Jessie at FCNL for kicking off this change.

6/4/19¶

Documentation Search¶

Introducing improved documentation search! We've switched to a new tool for searching. Enter one or more words in the search box on the Support Tab or the sidebar in the documentation and you'll see a list of potential matches. Select from that list or hit return to see a list of the potential matches with more context.

Multi-Campaign Event Search¶

Let your users search across multiple event campaigns using the new "Also Search Campaigns" feature! In the event campaign settings screen, you can specify one or more related campaigns.

Those campaigns appear with pre-checked checkboxes on the event search page so users can choose whether to also search those campaigns.

We've updated the Original templateset and patched client templatesets if possible. To remove the checkbox or add it where we weren't able, look in the event_search.html and event_attend.html templates for lines which reference also_search or search_campaign.

If you remove the checkbox from event_search.html or your template is sufficiently different from Original's that the patch doesn't apply, we'll search any Also Search campaigns.

This does not affect mailing targeting or snippets -- you still need to manually include all event campaigns you want a mailing to include.

New Permissions¶

We've added new permissions for managing model mailings and model pages so only designated users can create and edit models. Staff users who already have Pages - Edit, View, Create and Mailings - Edit (with or without send) permissions currently have access to managing models, so they will be granted these new permissions automatically. You may want to consider and remove the new models permissions for some staff users. Note: The All Models permission is unrelated to this change -- it's used for granting unlimited access.

5/9/19¶

One-off queries!¶

As promised, the life changing magic of temp queries will arrive in your instance tomorrow morning. You'll be able to run a query (using SQL or the Query Builder), see the results on the same screen, and edit and rerun to your heart's content. If you realize this is a useful report that you want to save, you can do so. You can also email or download the results.

Events¶

Include multiple event campaigns in one mailing¶

We've made it possible to include multiple event campaigns in one mailing so you can easily do things like recruit attendees to the closest event across campaigns. You can do this using the new snippets that work with the event campaigns selected on the targeting screen. Just select multiple campaigns!

Alternatively, you can use a campaigns parameter with a comma- or space-separated list of campaign names with the {% withevents %} tag, listing the campaign shortnames between single quotes with the parameter campaigns:

{% requires_value user.id %}
{% withevents with user as nearby_user 'party onemoreparty' as campaigns 30 as radius 30 as limit %}{% requires_value events %}
{% for event in events %}
<blockquote>
    Event: {{ event.title }}<br />
    {{ event.starts_at_full }} <br />
</blockquote>
{% endfor %}
{% endwithevents %}

The event search is conducted across all of the provided campaigns at once so that sorting can be applied to all of the results.

In the next release, we'll be adding support for including multiple campaigns on your event search page and map.

Host tools login¶

If you include a link to the host tools page in your bulk mailing to hosts, you can apply the login_string filter and hosts will be able to click through to their events without logging in or setting a password.

Silent event changes¶

In some cases, you may want to cancel or otherwise modify an event without sending a notification to the host. We now allow both staff and moderators to suppress notifications to hosts, although the suppression option may not work if you have heavily-customized moderation templates. Thanks Everytown, FCNL, and J Street for the requests!

Query string with corrected campaign name¶

If end users visit an event page with both a campaign name and an event ID, we redirect them to the equivalent URL with the correct campaign name filled in -- important if you're reassigning events to different campaigns through the API.

These redirects used to drop the user's initial query string, but we now preserve that information through the redirect. Thanks Ethan at People Power for the suggestion.

4/23/19¶

Event hosts can now email attendees even when their events have hundreds or thousands of attendees without experiencing timeouts. Event-related messages have been moved to a background job if there are more than 20 recipients. Thanks to MoveOn and Courage Campaign for running huge events and requesting this feature!

The Salesforce sync is now officially out of beta. Thanks to the Courage Campaign, First Look Media, J Street, Ultraviolet and Faith in Public Life for helping us shake out the big bugs. The changes you'll see in this release:

• Take control of which ActionKit donations sync to Salesforce with the new Salesforce Donation Sync report. For users that are synced to Salesforce, only donations and payments selected by a report categorized salesforce_donations_sync will transfer to Salesforce. By default, that'll be all donations. Thanks Alon at J Street for the request!
• We resolved an issue that caused some recurring donations to skip pledges. The missing installments were being added by a fixer script we've been running, but that used extra API calls. With this change we'll use fewer API calls. Thanks LJ at First Look Media for letting us know!
• We're using core_transaction.trans_id field for de-duplicating transactions between ActionKit and Salesforce, instead of core_order.id so we've removed order_ID mapping setting.

Miscellany¶

• We made a few more changes to international geocoding. We'll geocode international users, even without a full address, so they can be targeted for timezone specific sends. And we will not re-geocode international users unless their address has changed.
• We updated permissions so staff with Pages permissions can create and edit Event Moderation pages. Thanks Scott at MoveOn for the request.
• Whenever you save changes to a legislative or special target group, ActionKit will redistribute signatures for pages using that target group. Thanks to Manny at MoveOn for the report.
• The query builder now recognizes that "active" recurring orders include both those with status active and status past_due.
• In a previous release, we added support for geocoding events to their corresponding state legislative districts. That's now available in the query builder so that you can easily generate reports by the state legislative district where events are taking place.
• When you set up automatic delivery using the batch option for petition or letter pages you need to manually include a link where your page's targets can download the signatures. This was too easy to forget! We've made the link required and available in the snippet menu for easy insertion. Thanks Conen at Progress Now for flagging the issue most recently.

3/27/19¶

Upload event signups¶

You now have the option to bulk upload a CSV of signups for a particular event from the Event Campaign Dashboard screen, next to the event signup page. Event signup uploads work just like user imports or event host uploads.

Each row of your file must include the event ID and the user's AKID or email address and can include other user information. Include an attended column with a value of 1 for users who were present or 0 for users who were not. Blanks leave a user's attendance record as is.

Each user who is uploaded will receive a confirmation email if you have one for the relevant event signup page. Suppress the confirmation message by changing Upload Settings or including a column, skip_confirmation, with a value of 1. If you're marking attendance, remember to suppress the confirmation so you don't remind users about the event they've already attended.

Relatedly, we've moved the "upload events" link next to the event creation page. For clients managing multilingual event campaigns, this means you can now upload events to each of your campaign's language-specific event creation pages, reflecting the language of the event creator.

3/6/19¶

Reports¶

• Reusable reports are now easier to share and edit. See and edit parameters at the top of the report results screen.

• Filtering on the user's email domain in donations query builder will no longer attempt to match the full user email address instead of the domain.
• The Download Actions report can now successfully handle custom action fields with apostrophes. Thanks to Kenton at PCCC and Will at ECU for reporting the issue!
• In the Users query builder, if you used the "Amount Of [First/Most Recent/Highest] Payment [During Time Period]" item using the modes "First Payment", "Most Recent Payment", or "Most Recent One-Time Payment", and you also specified a date range rather than "On Any Date", you would get a SQL error that prevented the query from running. Thanks to Matt at 350 for finding this error!

Salesforce (Beta)¶

• We no longer attempt to sync ActionKit users to Salesforce if they don't have a last name (required by Salesforce), even if you forget to exclude them in your sync report, saving you API calls.
• We include a built-in limit on percent of Salesforce API calls used to avoid maxing out your Salesforce org's daily calls. You can now configure that limit in the Salesforce integration settings to suit your needs based on how ActionKit fits into your Salesforce implementation.
• In ActionKit users' donation history, donations from Salesforce now include "From Salesforce" in the one-line record summary.

2/19/19¶

Re-Send Confirmation Mailings¶

When a user misses a confirmation mailing, they may get in touch asking for a copy. We added a link under eligible actions in the user's action history tab so you can resend confirmation mailings for actions on event creation, donation, recurring donation update or cancellation pages. This link will only show for actions completed after this release. A copy of the original mailing, including user-specific information about their donation or event, is resent and an additional transactional email is recorded and displayed on the user record. Thanks to NRDC, Represent.Us and Marguerite at First Look Media, among others, for requesting.

ACH (Beta)¶

• We've added the ability to override ACH verification for staff with the Manage Donations permission. This means they can override ACH without requiring bank login or a deposit verification just as they can update credit card numbers and bank information.
• The update recurring form in the admin UI now supports ACH updates in addition to credit card updates for staff with the Manage Donations permission. Thanks to NRDC for the request.

1/29/19¶

1/3/19¶

New federal legislators went live in your instance on January 3. We're continuing to update with new office data and state and local data as it becomes available.

12/5/18¶

11/28/18¶

10/29/18¶

10/10/18¶

9/26/18¶

9/10/18¶

8/29/18¶

8/21/18¶

8/14/18¶

7/31/18¶

7/10/18¶

6/13/18¶

6/6/18¶

5/24/18 (privacy and GDPR update)¶

We want to share a few more details on privacy features that were included in our latest release, but weren't explicitly called out in the release notes.

The updated documentation has details, and developers might find the new Original/privacy.html a useful reference. The biggest changes are:

1 We've redone the default privacy UI for users. Instead of checkboxes, Original/privacy.html can now show opt-in/out radio buttons, along with a notice and extra text to ask users to reconsider opting out.

2 Recognized users can be shown the privacy UI. You can show privacy options to recognized users in all of the countries you've configured by adding this tag to your form:

<input type="hidden" name="privacy_show_if" value="in_country">

You can use a value of 'missing' instead of 'in_country' to show the options only to those who don't have an active privacy record.

3 Opt-outs can unsubscribe users. Adding this tag to your form:

<input type="hidden" name="privacy_optout_unsub_all" value="1">

will unsubscribe users that opt out.

4 New options for handling confirmation emails. The section Handling confirmation emails in the docs covers how you can tweak or skip confirmation emails for opted-out users, with sample code.

5 Privacy records are visible in the user admin. Users with privacy records now have a "Privacy records" line in the "User details" section, and privacy records in the action history next to the corresponding action.

"Pre-GDPR" records coming shortly. If you've configured countries for privacy record support, we'll create records with type="pre_gdpr" and status="auto" soon.

As always, let us know through Support if you have any questions or need help.

5/23/18¶

ActionKitties are awesome! Everything in the release notes this time was inspired or reported by clients.

5/9/18¶

Hey ActionKitties! We've got a crazy cool new feature, custom boundaries, coming out in this release as well as some small improvements that bring me great joy (editable phone number display for call pages! a list of mailing test groups!). I am also joyful about seeing many of you in June! This will be our biggest ClientCon with ~55 clients attending. You can still sign up for training on Friday, June 22 for $500 per person.

Anyhoo, just forget about the world for a moment and join me in rejoicing over small things!

4/25/18¶

Hey ActionKitties!

Tomorrow morning you’ll see new options for using social media to pressure your advocacy targets, more autocomplete options for reports, and tools to help you comply with GDPR.

And two reminders:

• There are a few links to the user manual in these notes. Those links will work tomorrow, once the release it out, but not before then.
• ClientCon 2018 is coming soon (June 20-21 in DC). This is a day and a half client-only conference (followed by an optional one-day training that we'll email about later this week). Learn more and sign up here.

SELECT user_id FROM core_usergeofield
WHERE name = 'us_district_redistrict_2018'
      AND value IN ('PA_01', 'PA_02');

3/28/18¶

Hey ActionKitties!

We've added a bunch of functionality to the admin and API to make complying with GDPR requirements easier for ActionKitties with European signers.

Our consent feature, to more easily track opt-ins, needs a bit more testing before going live and will be in our next release in early April.

Not subject to GDPR? There are still some goodies in here for you: A/B testing improvements, more granular permissions for reports and speeding up bulk mailings by a factor of 4x.

All this and more will be available in an ActionKit instance near you tomorrow, March 29th.

3/13/18¶

Hey ActionKitties! Do you enjoy these release notes? Are there people at your organization who might find them useful? Please forward this ActionKitties sign up link to anyone who might be interested:

http://clientcon.actionkit.com/signup/actionkit_public/

2/28/18¶

Hey ActionKitties! Just a few new things coming to your instance late tonight. We're continuing work on events improvements (like adding an event moderation tool and support for timezones), Instant Donate upgrades, exposing social media info for advocacy targets, and more.

2/27/18 (announcement re: GDPR compliance)¶

Hi ActionKitties:

Europe will begin enforcing its General Data Protection Regulation (GDPR) at the end of May 2018.

These regulations give EU residents greater control and ownership of their personal information. The penalties for not complying with GDPR can be as significant as the larger of 4% of annual revenue or EUR20mm.

We've been working with our vendors to verify that they will all be GDPR compliant on or before the May 25th, 2018 deadline. All of our impacted vendors either are or will be compliant before the deadline.

You can build a GDPR-compliant solution on ActionKit today, but there are two specific GDPR requirements that we'll be making easier for you to comply with in the near future.

The first is the "Right to Erasure". EU subjects have the right to request that you delete or anonymize any data you've collected from them.

We'll be implementing an anonyimization feature, accessible via both the ActionKit admin UI and a REST API endpoint, that, given an ActionKit user id or email, will anonymize all of the personal information we've collected on that individual (specifically, all data stored in core_user, core_user_original and, optionally, core_order_user_detail tables). We will also track that that user id was anonymized for audit purposes.

This anonymization is permanent and irrevocable. We will not be able to honor any requests to restore data anonymized via this feature.

The second requirement is that you obtain the consent of EU subjects to collect and use their data. EU subjects must positively opt into any data collection. A pre-checked checkbox or language buried deep in a linked privacy policy is not sufficient to comply with this requirement.

To track consent, we will be implementing a system that allows administrators to define default consent wording for each language, along with the ability to override this language on a per-page basis.

You will be able to choose whether this language is displayed for all users or only for a list of countries that you designate.

If the consent language is displayed, the associated checkbox will need to be checked for the action to be processed. We will also record the consent language that we served, along with a timestamp, for every action, so you will have a permanent audit record.

You will be able to deploy this functionality regardless of whether you host your pages directly on ActionKit or embed them in your own CMS.

If you have existing consent information that you want to port over to our tracking system, let us know and we will work with you to figure out a migration process.

Both of these features will be available in your instance in March.

Finally, the GDPR landscape will evolve over time. We'll continue to monitor the state of the art and expect to revise and add to this feature set in the future.

If you have any questions or thoughts, please let me know.

2/14/18¶

Hey ActionKitties! We’ve got a big one coming your way this evening with lots of juicy new bits.

Support for Partial Refunds (currently Braintree only): You can refund part of a donor’s one time donation or recurring payment, if the donation was processed through Braintree. We’ll be adding support for partial refunds at other merchant vendors in the coming weeks.

You prompt a partial refund by clicking 'Reverse' from the user’s Donation or Action History screen, just as you would for a full refund. This brings you to the 'Reverse Donation' screen and if the donation has settled, you’ll see a link to 'issue a partial refund'.

Click that link and a box with the amount available for refund will display. We subtract any previous partial refunds so you can’t refund more than was donated.

Braintree donations generally settle overnight and you’ll see this message until partial refund is available.

For reporting purposes, ActionKit will reduce the amount in core_order by the amount refunded, and add a row to core_transaction with type='credit' and the amount refunded as a negative value. As of this month, query builder reports and ActionKit built-in reports that reference core_transaction count credits where applicable.

New Options for A/B Testing on Pages: You’ll see a few new checkboxes under 'Fields to Change' on the A/B Test screen for Pages.

The Statement Lead-in Text option corresponds to the Lead-in Text on both Petition and Letter page types. It has no effect on other page types. Similarly, the Statement/Letter Text option allows you to test variations in the script for Call and Whipcount page types, and the statement for Petition page types. Finally, the Survey Question option exposes the survey question for Call, Whipcount and Unsubscribe page types. You can see all this info in the tooltip for the relevant option.

There's also a new checkbox that allows you to test user recognition. This will modify the page setting that controls whether user AKID recognition is disabled, or is disabled for users who've already taken at least one action. Thanks to Mark at CREDO for requesting!

We documented how to use custom page fields and templates to A/B test page layout changes like disabling the thermometer.

And we added tooltips to each of the statistics on the Test Dashboard providing a bit more information about how the number is calculated. Thanks to Shannon at UltraViolet for highlighting the value of this and suggesting some descriptions.

Instant Donate: Thanks to those who took me up on the offer to see our Instant Donate set up. We got some excellent feedback and as a result have started on adding a monthly upsell to the flow. This will be built into the Original templateset for Instant Donate only. Expect to see this in the next release or three.

We also hotfixed a change that makes it possible to override the default button style for the one click snippets in the mailer. You can’t change the text or the basic structure but the appearance can be modified to match your look and feel. Details are in the Instant Donate section of the guide.

1/31/18¶

Hey ActionKitties! For this release we banged out some bug fixes and minor improvements, which you'll see in your instance by tomorrow morning.

1/15/18¶

Happy New Year ActionKitties! In this release we have a few improvements to our code related to advocacy targets and we’ve added tracking for event-related transactional emails. As usual, you will see these changes in your instance tomorrow. Also, we’re starting to make plans for ClientCon 2018! Watch your inboxes for a survey on timing and location.

Earlier Releases¶