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
Section titled “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 seller’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] |
Shopper currency picker |
Marketplace pages
Section titled “Marketplace pages”[wpss_services] – Services catalog
Section titled “[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"][wpss_featured_services] – Featured services
Section titled “[wpss_featured_services] – Featured services”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"][wpss_service_search] – Search bar
Section titled “[wpss_service_search] – Search bar”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 seller’s card
Section titled “[wpss_seller_card] – One seller’s card”Renders a single seller 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 seller’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
Section titled “[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
Section titled “[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
Section titled “[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
Section titled “Vendor elements”[wpss_vendors] – Vendor directory
Section titled “[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
Section titled “[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
Section titled “[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
Section titled “User pages”[wpss_dashboard] – Unified dashboard
Section titled “[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
Section titled “[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
Section titled “[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
Section titled “[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
Section titled “Accounts and checkout”[wpss_login] – Login form
Section titled “[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
Section titled “[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
Section titled “[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
Section titled “[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
Section titled “[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
Section titled “[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.
[wpss_currency_switcher] [PRO]
Section titled “[wpss_currency_switcher] [PRO]”A currency picker for shoppers. 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
Section titled “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"] |
- 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.