Newspack’s Donate Block can be used to manually place a donation block manually on any post or page on your site.

Using the Newspack Donate Block

Before using the Newspack Donate Block, you will need to complete the Reader Revenue Wizard setup.

Once that’s complete, you can add a Newspack Donate Block by following these steps:

  1. Edit the post or page where you would like to add the block.
  2. Open the Gutenberg block selector and search for ‘Donate’, or scroll down to the Newspack section of the dropdown and pick Donate:
  1. This will add the Donate Block to your editor with its default configuration.
  2. Click Update or Publish to save your changes.

Configuring the block manually

Out of the box, the block will use the default settings from Dashboard > Newspack > Reader Revenue, but you can configure an individual block manually once it’s been added to the page by following these steps:

  1. Select the block in the editor:
  1. In the right sidebar, select Block tab at the top. If the right sidebar is not visible in the editor, it can be opened by clicking the cog icon in the top-right corner:
  1. Under Donate Block, you can toggle on Configure manually and change the suggest amounts for each of the tiers. These will automatically be multiplied by 12 for the Annual and One-Time tabs. You can also switch whether the one block will display tiered pricing. If you turn on Configure manually on a block, it will no longer be affected by the global defaults you set under Reader Revenue.
  1. Under Default Tab, you can change the default tab on the block from “Monthly” to one of the other tab options, “One-time” or “Annually”:
  1. Under Campaigns, if you have a Campaign ID provided to you by a third-party (like News Revenue Hub), it can be entered here:
  1. Once you’ve finished editing the block, click Update or Publish to save your changes.

Stripe on-site checkout

If your site is using the “AMP Plus” mode, Stripe can be set as the Reader Revenue platform:

Then, the Donate block will handle the donation without any redirects. After user clicks the call-to-action (“Donate now!”, by default), they will see a form where they can enter their credit card information:

Newsletter sign-up opt-in

To enable donors to sign up for the newsletter when they donate, visit Reader Revenue > Stripe Settings. If you’ve configured an Email Service Provider (e.g. Mailchimp) in Newspack Newsletters, you’ll be able to choose a list:

Option to cover fees

The donor will be asked to cover Stripe fees by default. The fee parameters can be updated, but there’s not user interface for this yet. Currently the parameters are Stripe’s default 2.9% + 30 cents.