Blocks

Blocks »Simple Payments Block

The Simple Payments block lets you add a payment button to any post or page, and immediately start taking PayPal payments for physical products, digital goods, or donations.

Are you using our Classic editor? Click here for Classic editor instructions.

Block Interface
Editing the Form
Styling The Payments Button
Classic Editor Instructions
Adding a Widget
Collecting Payments

To use the Simple Payments block, your site needs to have an active WordPress.com Premium or Business plan.

In order to add a Simple Payments block, click on the Block Inserter icon.

You can also type /simple and hit enter in a new paragraph block to add one quickly.

Detailed instructions on adding blocks can be found here.


Block Interface

Each block has its own block-specific controls that allow you to manipulate the block right in the editor.

The Simple Payments block offers the more option control by default. Once you add an image, icons to edit or trash the image will appear.

Simple-Payments-Block-Toolbar

↑ Table of Contents ↑

Editing the Form

When you first add the Simple Payments block, a few fields will be loaded for you to fill in as shown below.

  1. Upload or select an image from the media gallery.
  2. Enter the name of the item you are selling.
  3. Enter a brief description of the item.
  4. Select your currency and enter the price (without a currency symbol).
  5. Select whether to allow people to buy more than one of the item at once.
  6. Enter your PayPal email address.

The email address you enter will determine where PayPal sends payments for the items sold or donations collected. Double-check the email address you enter to be sure it is valid and belongs to you! You will also need a free PayPal account linked to your bank account to claim any payments you receive.

This is how the product will look on the actual site:

Simple-Payments-Block-Result

That’s it. You are ready to sell!

You can add as many Simple Payments buttons as you like to your page by repeating the process above.

Read about collecting payments here.


↑ Table of Contents ↑

Styling The Payments Button

For information on how to style aspects of the button, please see our Simple Payments styling page.

↑ Table of Contents ↑

Classic Editor Instructions

If you are using the WordPress Editor (Blocks), click here.

Create Your First Button
Button Details
Updating and Adding Buttons
Styling the Payments Button
Adding a Widget
Collecting Payments


↑ Table of Contents ↑

Create Your First Button

To add a Simple Payments button, go to My Sites → Site → Pages Add New Page. You can also add a Simple Payment button to existing Posts or Pages by editing them in the Classic Editor.

In the toolbar, click the “⊕ Add” and then the option to add a Payment Button will appear like in the example below:

Add a payment button

If this is your first button you will see the create new button form:

Adding a new payment button

↑ Table of Contents ↑

Button Details

Adding an Image

Adding an image

You can click Add an Image or drag and drop an image onto the form to add an image to your button. After adding the image you will be see the image editing tools:

Editing an image

Click Done when you are ready to upload the image. After the image finishes uploading you can make additional edits to the image by clicking the pencil icon. To change the image click the ✕ on the top right of the current image and add a new one.

Clicking "Done" adds the image

Adding Details

Adding details and description

Fill in the Name, Description, and Price for the item you are selling. You can set the currency by clicking the currency button to the left of the Price input:

Updating payment currency

These are the currencies supported by our PayPal integration.

The toggle below Price enables the multiples option. If enabled the button will show an input field that allows people to purchase more than one item at at time.

Payments captured by your new button will be paid out to the email address you add to the button. Double check the email address you entered. Payments are fulfilled by PayPal but you don’t need an existing account to start collecting payments on your site. Any email address that you have access to will work to get started.

When you are ready click Insert. This will embed your new button into your Post or Page.

Clicking "Insert" adds payment button

↑ Table of Contents ↑

Updating and Adding Buttons

Now that you have your first button created you can make changes or insert it into more Posts and Pages.

To update or add Simple Payments button, go to My Sites → Site → Pages Add New Page or by opening an existing Post or Page in the Classic Editor.

In the toolbar, click the ⌄ next to the ⊕ symbol, and then the option to add a payment button. You will now see a list of all the buttons you have created:

Add new payment button

Adding Buttons

Read about collecting payments here.

You can add an existing button to any Post or Page by selecting any button in the list and clicking Insert:

Add existing button

Or you can add a new button by clicking Add New in the top right corner of the list.

Deleting Buttons

You can delete buttons from the Simple Payments button list. Click the ellipsis on the far right side of the button you want to delete:

Delete payment button

Clicking the trash can will disable the button from all Posts and Pages immediately. Also, the Simple Payments button will no longer be displayed anywhere on the site.

Please note that WordPress.com pages are cached to provide your site visitors a great web experience. Cached pages can sometimes show old content which means a deleted Simple Payments button might still appear on a Post or Page. This should only happen for a few minutes however, updating a Post or Page will remove any deleted buttons immediately from that Post or Page.

You can also remove a button from a single Post or Page. Open the Post or Page you want to remove the button from in the Visual Editor. Click on the Simple Payment button you want removed:

Deleting a payment button from the visual editor

Click the ✕ to remove the button and update the Post or Page to save your changes.

Editing Buttons

You can edit any existing button from the ellipsis menu in the button list:

Edit payment button

or from clicking an embedded button in the Visual Editor:

Editing a payment button from the visual editor

Any applied changes will appear everywhere the button is displayed on the site.


↑ Table of Contents ↑

Styling The Payments Button

For information on how to style aspects of the button, please see our Simple Payments styling page.

Simple Payments Block
Classic Editor Instructions

Collecting Payments

↑ Table of Contents ↑

Adding a Widget

On WordPress.com and Jetpack 6.3 or above, you can add a quick payment option to any widgetized area (sidebar, footer, etc.) on your WordPress site.

Here’s an example from a footer area:

To add a widget, go to My Sites → DesignCustomize to load the site customizer. From the Customizer menu, click on Widgets and then select the area of your site where you’d like the widget to appear.

At the bottom of this menu, click the Add Widget button, and look for Simple Payments in the list.

You can then choose which product to display in the widget. If you don’t have any products yet, you can create one right inside the widget by clicking Add New.

For each new product, you can add everything you can on a standalone Simple Payment Button, including a photo, description, and price.

Once one or more products have been created and saved via the Customizer, you can switch between them when adding a new widget or payment button. Just choose from the right button in the list when you’re setting up and you’re good to go!

After selecting a product, you can change the widget options, reorder it, and see how it will look on the page. Once you’re happy with how it looks, click Publish at the top of the Customizer sidebar to save your site layout with the new widget.

Simple Payments Block
Classic Editor Instructions
Adding a Widget

↑ Table of Contents ↑

Collecting Payments

Please note that your site must be public before you can collect payments. You are able to create and add buttons but you will not be able to collect payments on a private site.

When a visitor to your site clicks the pay with PayPal button on any of your Simple Payment buttons, a new window will open that will take them through the PayPal checkout. They will have the option to pay you from their PayPal account using PayPal funds or a credit card. If they are logged into PayPal and have access to PayPal Credit as a payment method they’ll also see the PayPal Credit button.

If you have a Business PayPal account, they will have the option to simply use a credit or debit card to complete the purchase without having a PayPal account.

PayPal checkout screen

All payments are credited to the PayPal account linked to the email address used in the button. For every purchase PayPal will send a confirmation email with the purchaser’s information to this email address. The purchaser will also receive an email from PayPal as a receipt for the purchase.

If the email you use is not linked to an existing PayPal account, you will receive an email from PayPal with information about claiming any collected payments. This email is sent after you collect your first payment. Be sure to check that PayPal supports collecting online payments in your region. You will need Business Account support which you can determine for your country by following PayPal’s online support.

WordPress.com will also send an email for each purchase. This email will be sent to the user’s email who created the button. You can also expect a monthly report for all your Simple Payment buttons. This email is sent to the site plan owner.

Not quite what you're looking for?

Get Help