Use the pmpro_addon_packages shortcode to build a shop page that lists your Addon Packages, each with a button to buy it or view it.

Add the Shortcode to a Page

Add a Shortcode block to any page and enter the pmpro_addon_packages shortcode with the attributes you want. With no attributes, it lists every published post and page that has a package price, in a table, ordered by menu order.

[pmpro_addon_packages]

Shortcode Attributes

AttributeAccepted ValuesDefaultDescription
checkout_buttonAny textBuy NowText for the button that links to checkout. The package price is added after the text.
excludeComma-separated post IDsNonePackages to leave out of the list.
includesubpages or comma-separated post IDsAll packagesUse subpages to list only packages that are child pages of the page with the shortcode. Use post IDs to list only those packages.
layouttable, div, 2col, 3col, or 4coltableHow to display the packages. The column layouts use grid classes from the Memberlite theme and other themes built on the Foundation grid.
levels_buttonAny textChoose a LevelText for the button shown when there is no level the visitor can check out with. The button links to your Membership Levels page.
linktrue or falsetrueLink each package title and image to the package. The values false, 0, and no turn links off.
orderASC or DESCASCSort direction.
orderbyAny WP_Query orderby value, such as title, date, or menu_ordermenu_orderHow to sort the packages.
thumbnailthumbnail, medium, large, or falsethumbnailFeatured image size to show for each package, or false to hide images. Any other value uses thumbnail.
view_buttonAny textView NowText for the button shown on packages the visitor already has access to.

Which Button Each Package Shows

Each package in the list shows one button, based on the person viewing the page:

  • View Button: The logged-in member already has access to the package. Links to the package.
  • Checkout Button: The Add On found a level to check out with, using the same rules as the checkout link on a package. Shows the button text followed by the package price and links to checkout.
  • Levels Button: There is no level the visitor can check out with. Links to your Membership Levels page.

Examples

Table Layout

[pmpro_addon_packages layout="table" orderby="menu_order"]
Table layout of four Addon Packages with thumbnails, titles, Buy Now buttons with prices, and a View Now button on the package the member already bought

Three Column Layout

[pmpro_addon_packages layout="3col" orderby="menu_order"]
Three column layout of Addon Packages with centered images, titles, and Buy Now or View Now buttons

Only Specific Packages, Without Images

[pmpro_addon_packages include="123,456" thumbnail="false" checkout_button="Buy This Lesson"]

Why a Package Is Missing From the List

  • Filter Searches and Archives: If Filter searches and archives? is set to “Yes” under Memberships > Settings > Advanced, Paid Memberships Pro hides restricted posts from visitors who don’t have a required level. The shortcode list is filtered too, so logged-out visitors and members of other levels may see “No add on packages found.” Set it to “No” if your shop page should list packages for everyone. Lists that use include="subpages" are not filtered.
  • Not Published or No Price: Only published posts and pages with a price greater than 0 are listed.
  • Custom Post Types: The shortcode lists posts and pages. Post types added through the Custom Post Type (CPT) Membership Access Add On aren’t included automatically. Developers can add them with the pmproap_supported_post_types filter or change the whole query with pmproap_shortcode_query_args.

Use a Custom Shortcode Template

To change the shortcode’s HTML, copy shortcodes/pmpro-addon-packages-shortcode.php from the Add On’s folder into your active theme (use a child theme) at this path:

your-theme/paid-memberships-pro/pmpro-addon-packages/pmpro-addon-packages-shortcode.php

When this file exists, the Add On loads it instead of its own shortcode file. Your copy replaces the whole file, so it must still register the pmpro_addon_packages shortcode. Check your copy against the Add On’s version after each update.

Last updated on November 19, 2026


Was this article helpful?
YesNo