Shortcodes Reference

WP Sell Services registers 19 shortcodes, and WP Sell Services Pro adds one more. Together they build every part of your marketplace -- catalog, vendor directory, dashboard, buyer requests board, checkout -- with no code.

Paste a shortcode into any page or widget, publish, and it works. Every one is also available as a block; see Block Editor Elements.

The plugin auto-creates the most important pages during setup, so you may already have most of these in place. See Pages Setup.

Quick reference#

Shortcode What it renders
[wpss_services] Services catalog grid
[wpss_featured_services] Featured services only
[wpss_service_search] Search form with category dropdown
[wpss_service_categories] Category grid
[wpss_vendors] Vendor directory grid
[wpss_top_vendors] Highest-rated vendors
[wpss_vendor_profile] One vendor's full profile
[wpss_seller_card] One vendor's card (avatar, rating, stats)
[wpss_buyer_requests] Open buyer requests board
[wpss_post_request] Form to submit a buyer request
[wpss_dashboard] Unified buyer/vendor dashboard
[wpss_my_orders] The user's order list
[wpss_order_details] One order's detail view
[wpss_service_wizard] Service creation wizard
[wpss_login] Login form
[wpss_register] Registration form
[wpss_vendor_registration] Become-a-vendor form
[wpss_cart] Shopping cart
[wpss_checkout] Standalone checkout
[wpss_account] Standalone account page
[wpss_currency_switcher] [PRO] Optional shopper currency selector (off by default)

Marketplace pages#

[wpss_services] -- Services catalog#

A grid of published services with thumbnails, prices, ratings, and vendor info. The main browsing page of your marketplace.

Attribute Default Notes
category (empty) Limit to a category
tag (empty) Limit to a tag
vendor (empty) Limit to one vendor
limit 12 Services shown
columns 4 Grid columns
orderby date date, title, price, rating, sales
order DESC ASC or DESC
featured (empty) true to show featured only

Sorting never hides a service. With orderby="rating" or orderby="sales", services that have no rating or no completed order yet are listed after the ones that do, newest first. orderby="price" uses the starting price: cheapest first with order="ASC", most expensive first otherwise.

Services from a vendor who is on vacation are left out, the same as in the catalog and search. The exception is a grid limited to one vendor with vendor="...", which always shows that vendor's services.

[wpss_services category="design" limit="8" columns="4" orderby="rating"]

Identical to [wpss_services] with featured forced on, so it accepts all the same attributes. Use it for homepage spotlights and Editor's Picks.

[wpss_featured_services limit="4" columns="4"]

A search form with a keyword field and category dropdown. Put it on your homepage or above your services grid.

Attribute Default
placeholder Search services...
show_categories true
button_text Search
action the service archive URL 
[wpss_service_search placeholder="What do you need?" button_text="Find a pro"]

[wpss_seller_card] -- One vendor's card#

Renders a single vendor card: avatar, name, rating, stats and a link through to their profile. It wraps the wpss/seller-card block rather than re-rendering the markup, so the block and the shortcode cannot drift apart.

With no attributes it uses the vendor whose profile is being viewed, which makes it drop-in inside a vendor template. Pass user_id to pin it to someone specific.

[wpss_seller_card]
[wpss_seller_card user_id="12" layout="horizontal" show_bio="false"]
Attribute Default What it does
user_id 0 Whose card to show. 0 uses the vendor being viewed.
layout vertical vertical or horizontal.
show_bio true Show the vendor's short bio.
show_stats true Show order and completion stats.
show_rating true Show the star rating.
show_services true Show a count of their live services.
show_button true Show the button through to the full profile.

[wpss_service_categories] -- Category grid#

Your categories as a visual grid with counts.

Attribute Default Notes
parent 0 Parent term id; 0 for top level
show_count true Show the service count
columns 4 Grid columns
hide_empty true Hide categories with no services
limit 12 Categories shown

[wpss_buyer_requests] -- Buyer requests board#

Open buyer requests so vendors can browse projects and submit proposals. Also works as a compact sidebar listing -- just lower the limit.

Attribute Default
limit 10
category (empty)
budget_min (empty)
budget_max (empty) 
[wpss_buyer_requests limit="5" budget_min="500"]

The request cards carry their own styling, so the board looks the same on any page, in any theme, as it does on the buyer requests archive.

[wpss_post_request] -- Post a request form#

The same Post a Request form as the dashboard (title, description, category, budget, deadline, skills, attachments). Requires the user to be logged in. A theme override of dashboard/sections/create-request.php changes both. No attributes.

The form loads its own styles and script wherever it is placed, including inside a synced pattern, a widget, or a page builder.

Vendor elements#

[wpss_vendors] -- Vendor directory#

A grid of vendor profiles with names, avatars, ratings, and review counts.

Attribute Default Notes
limit 12 Vendors shown
columns 4 Grid columns
orderby rating rating, date, name, sales
order DESC ASC or DESC

[wpss_top_vendors] -- Top vendors#

[wpss_vendors] with orderby="rating" and order="DESC" forced. Accepts limit and columns.

[wpss_top_vendors limit="6" columns="3"]

[wpss_vendor_profile] -- Vendor profile#

One vendor's full profile page.

Attribute Default
id the vendor_id query var

On a dedicated profile page the id comes from the URL, so you can usually omit it. If no id is found, the shortcode renders "Vendor not found."

User pages#

[wpss_dashboard] -- Unified dashboard#

The single most important element. One page that adapts to the visitor's role:

  • Buyers see orders, requests, messages, favorites, and profile settings
  • Vendors see services, sales orders, earnings, analytics, messages, and portfolio
  • Dual-role users see both

One page, one shortcode, serves everyone. No attributes.

[wpss_my_orders] -- Order list#

Attribute Default Notes
type customer customer (bought) or vendor (sold)
status (empty) Filter to one status
limit 20 Orders per page 
[wpss_my_orders type="vendor" status="in_progress"]

[wpss_order_details] -- Order detail#

The full details of one order. The order id comes from the URL. Only the buyer, the vendor, or an admin on that order can view it. No attributes.

[wpss_service_wizard] -- Service creation wizard#

The multi-step form vendors use to create a service.

Attribute Default Notes
id 0 Pass a service id to edit instead of create

Accounts and checkout#

[wpss_login] -- Login form#

Attribute Default
redirect (empty)

A sign-in card styled like the registration form. After signing in, visitors go back to the page they came from (?redirect_to=), else to redirect, else the home page. A wrong password returns to this card with a message.

Map the page under Settings > Pages > Log In and every Sign in link on the site (the plugin's and the theme's) goes to it instead of wp-login.php. wp-admin sign-in stays on wp-login.php. Choose None (use this site's own login) there to switch it off. The page is created automatically on new installs only; see Pages Setup.

Shows an "already logged in" message to authenticated users.

[wpss_register] -- Registration form#

Username, email, and password. Requires WordPress registration to be enabled in Settings > General ("Anyone can register") -- otherwise the form cannot create accounts. No attributes.

[wpss_vendor_registration] -- Become a vendor#

The vendor-specific registration form. Different from [wpss_register] -- use this on your "Become a Vendor" page. What it does depends on your registration mode (open, requires approval, or closed); see Vendor Settings. No attributes.

[wpss_cart] -- Shopping cart#

Selected services, packages, and add-ons with a total, before checkout. Buyers can remove items or continue. No attributes.

[wpss_checkout] -- Standalone checkout#

Billing details, order review, payment method, and Place Order. This is the checkout for standalone mode -- not used when WooCommerce or another e-commerce platform handles checkout. No attributes.

[wpss_account] -- My account#

Account management for standalone mode: profile, saved addresses, settings. Separate from the vendor dashboard. No attributes.

A logged-out visitor sees a sign-in prompt with a Log in button that leads to the site's sign-in page and returns them here afterwards.

Pro#

[wpss_currency_switcher] [PRO]#

An optional currency selector for shoppers; nothing shows one unless you place this shortcode. The currency is otherwise detected from the shopper's timezone. The selection is a display-only hint -- every order and payout stays in your base currency. See Display Currency. No attributes.

Where to use what#

Goal Recommended elements
Main browsing page [wpss_services] + [wpss_service_search]
Homepage [wpss_featured_services] + [wpss_service_categories] + [wpss_top_vendors]
User account area [wpss_dashboard]
Vendor recruitment page [wpss_vendor_registration]
Buyer request marketplace [wpss_buyer_requests] + [wpss_post_request]
Vendor directory page [wpss_vendors]
Sidebar [wpss_service_search], [wpss_top_vendors], [wpss_buyer_requests limit="5"]

Tips#

  • Start with the auto-created pages. Setup creates the essentials; customise from there.
  • Combine elements on one page -- search bar, then categories, then the grid.
  • All of these work in widgets, so sidebars and footers are fair game.
  • Prefer blocks if you use the block editor -- same features, visual controls. See Block Editor Elements.