PremiumPress
Members
← Back to documentation

PremiumPress Shortcodes Reference

This is the complete reference for the display shortcodes used across PremiumPress themes (DirectoryPress, CouponPress, AuctionPress, ClassifiedPress and the other responsive themes). Shortcodes let you control exactly what listing data appears, and where, inside your listing and template layouts.

How to use them: place a shortcode inside a listing template or a WordPress page/widget that renders listing data. Uppercase shortcodes below are the PremiumPress display tags. Many accept optional parameters (shown in examples).

Listing content & fields

ShortcodeWhat it outputs
[TITLE]The listing title (linked to the listing).
[TITLE-NOLINK]The listing title as plain text, with no link.
[CONTENT]The full listing description/content.
[EXCERPT]A shortened excerpt of the listing content.
[IMAGE]The listing's main/featured image.
[IMAGES]The listing's full image gallery.
[FIELDS]All custom fields for the listing. Hide specific fields with a parameter, e.g. [FIELDS hide="map"].
[FIELDLIST]Custom fields rendered as a compact list.
[LOCATION]The listing's location/address text.
[GOOGLEMAP]A Google Map for the listing location.
[DATE]The listing's publish date.
[AUTHOR]The listing author / owner.
[CATEGORY]The listing's primary category.
[CATEGORIES]All categories. Filter which show/hide, e.g. [CATEGORIES show="111,37" hide="0"].
[URL]The listing's external/website URL.
[VIDEO]An embedded video attached to the listing.
[HITS]The listing view count.
[LISTINGSTATUS]The current status of the listing (active, expired, etc.).

Buttons, contact & social

ShortcodeWhat it outputs
[CBUTTON]The primary call-to-action button for the listing.
[BUTTON]A generic action button.
[CONTACT]The listing's contact form / contact details.
[SOCIAL]Social share buttons.
[COMMENTS]The comments area for the listing.
[STORE]The store/vendor link. Customise the label with [STORE text="Visit store"].
[EDIT]An "edit listing" link (shown to the owner).

Listing grids & search

ShortcodeWhat it outputs
[LISTINGS]A grid/list of listings ? the core loop used to display multiple listings.
[CAROUSEL]Listings in a rotating carousel.
[RELATED]Related listings based on category/fields.
[ADVANCEDSEARCH]The advanced search form.
[CTAX key=XXXX]Outputs a specific custom taxonomy ? replace XXXX with the taxonomy key.
[TOOLBOX]The listing toolbox (owner/admin actions).

Membership & access control

Wrap content so it only shows to specific membership levels:

  • [MEMBERSHIP ID="1"] ? [/MEMBERSHIP] ? show the content only to members of level 1.
  • [MEMBERSHIP ID="1,2,3"] ? [/MEMBERSHIP] ? show to several levels at once.
  • [MEMBERSHIP ID="0"] ? [/MEMBERSHIP] ? show to non-members / logged-out visitors.
  • [HASVALUE] ? [/HASVALUE] ? only render the enclosed block when the field/value exists (avoids empty labels).

Coupon-theme shortcodes (CouponPress)

ShortcodeWhat it outputs
[COUPON]The coupon code / reveal button.
[COUPON_END]The coupon expiry as a live countdown (e.g. "Expires in 03 months, 16 days?").
[TIMELEFT]Time remaining before the listing/coupon expires.

Email shortcodes

Email Manager notifications use their own set of merge tags (for example the listing website, username and title values). These are configured under Email Manager ? Email Configuration and differ from the display shortcodes above ? insert them into the email template for each notification type.

Tips

  • Display shortcodes are designed to run inside listing templates; a shortcode placed on a normal page with no listing context has nothing to render.
  • Use [HASVALUE] wrappers to keep layouts clean when a field is empty.
  • Parameters (hide=, show=, text=, count=) may vary slightly by theme and version ? check your theme's template files if a parameter doesn't behave as expected.

Need a shortcode that isn't listed here, or custom behaviour? Our design & development service can help.