ClientPress includes one shortcode that you can place on any page or post to display a logged-in user’s accessible portals.
Shortcode #
[cp_portal_list]
Place this shortcode in any page, post, or widget area that supports shortcodes.
What It Displays #
When a logged-in user visits a page containing this shortcode, they see a list of all portals they have access to. Each portal name is a clickable link that takes them directly to that portal.
Attributes #
show_status(default:true) — Show a colored status badge (Active, Pending, Archived) next to each portal nameshow_logo(default:false) — Show the portal’s logo thumbnail next to each portal name
Example with all attributes:
[cp_portal_list show_status="true" show_logo="true"]
Example with just the list (no status badge):
[cp_portal_list show_status="false"]
Status Badge Colors #
When show_status="true", each portal displays a small pill badge:
- Active — Green
- Pending — Amber
- Archived — Gray
Behavior for Logged-Out Users #
If the visitor is not logged in, the shortcode outputs a simple login prompt instead of the portal list:
Please log in to view your portals.
The text links to the WordPress login page.
Behavior When No Portals Are Found #
If the logged-in user has no portals assigned to them, the shortcode outputs:
No portals found.
Common Use Cases #
- Account or dashboard page — Drop the shortcode on a “My Account” page so clients can access their portals from your site
- Navigation area — Some themes support shortcodes in widget areas near the header or sidebar
- Post-login landing page — Combine with the login redirect setting to give clients a friendly portal picker page
Alternative: Direct Link #
If you just need a link to send clients to their portals without embedding a list, you can link directly to /client-portal/ instead. See How to Link Clients to Their Portal.
