WP SmartPay provides a set of shortcodes for embedding payment forms, customer account pages, receipts, and dashboard widgets anywhere on your WordPress site. This page lists every shortcode with its parameters and usage examples.
Payment Form Shortcodes
[sp_form]
Embeds a payment form by ID. This is the current standard shortcode.
[sp_form id="123"]| Parameter | Required | Description |
|---|---|---|
id | Yes | The numeric ID of the payment form to embed. |
[smartpay_form]
Legacy form embed shortcode. Identical to [sp_form]; included for backward compatibility.
[smartpay_form id="123"][smartpay_product]
Renders a purchase button or product widget for a digital product.
[smartpay_product id="5"]| Parameter | Required | Description |
|---|---|---|
id | Yes | The numeric ID of the digital product. |
Account & Dashboard Shortcodes
[smartpay_user_login]
Displays a login form for customers. After login, redirects to the Login Page redirect URL set in General Settings.
[smartpay_user_login]No parameters. Place on a dedicated login page and set that page as the Login Page in SmartPay → Settings → General.
[smartpay_user_registration]
Displays a customer registration form that creates a WordPress user account.
[smartpay_user_registration][smartpay_user_profile]
Allows the logged-in customer to update their name, email, and password.
[smartpay_user_profile][smartpay_dashboard]
Shows the logged-in customer's complete payment history — all their past payments with amounts, dates, form names, and receipt links.
[smartpay_dashboard]Receipt Shortcode
[smartpay_payment_receipt]
Renders the payment receipt for the current transaction. This shortcode reads the payment ID from the URL query string automatically — place it on the page set as Payment Success Page in General Settings and it will always show the right receipt.
[smartpay_payment_receipt]Goal Progress Bar Shortcode (Pro)
[smartpay_goal]
Displays a fundraising progress bar for a specific revenue goal.
[smartpay_goal id="1"]| Parameter | Required | Description |
|---|---|---|
id | Yes | The numeric ID of the revenue goal. Find it in SmartPay → Reports → Goals. |
Campaign Shortcodes
[smartpay_campaign_progress]
Displays a campaign's progress bar (raised, donations, donors, days left).
[smartpay_campaign_progress id="12"]| Parameter | Required | Description |
|---|---|---|
id | Yes | Campaign ID (shown next to the title in SmartPay → Campaigns). |
Block equivalent: WPSmartPay Campaign Progress.
[smartpay_campaign_donors] (Pro)
Displays the campaign's donor wall. Shows nothing unless the campaign's donor list is Public. See Donor Wall.
[smartpay_campaign_donors id="12"]| Parameter | Required | Description |
|---|---|---|
id | Yes | Campaign ID. |
Block equivalent: WPSmartPay Campaign Donors.
Finding Shortcode IDs
The easiest way to find shortcode IDs:
- Forms — Go to SmartPay → Forms. The Shortcode column shows the full shortcode with the ID pre-filled.
- Products — Go to SmartPay → Products. Same as forms — the ID is in the shortcode column.
- Goals — Go to SmartPay → Reports → Goals. The shortcode is shown on each goal row.
- Campaigns — Go to SmartPay → Campaigns. The ID is shown next to each campaign title.
Usage Examples
Embed a campaign's progress bar above its donation form (or simply link to the campaign page at /campaign/{slug}):
[smartpay_campaign_progress id="12"]
[sp_form id="10"]Create a "My Account" page with login + dashboard:
[smartpay_user_login]
[smartpay_dashboard](The dashboard block only shows when the user is logged in; the login form only shows when they are not.)