Shortcode Reference
WP Stories provides five shortcodes for displaying stories in different contexts.
[wb-story]
Section titled “[wb-story]”Displays stories from a specific Story Box (created in the admin as a wb-story-box post type).
Parameters
Section titled “Parameters”| Parameter | Type | Required | Description |
|---|---|---|---|
id |
Integer | Yes | The Story Box post ID. |
Example
Section titled “Example”[wb-story id="42"][wb-story-activities]
Section titled “[wb-story-activities]”Displays all user-submitted stories in a feed layout. This is the primary shortcode for showing the story activity stream.
Parameters
Section titled “Parameters”| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
count |
Integer | No | All | Number of stories to display. |
form |
Integer (1 or 0) | No | 0 |
Set to 1 to show the story submission form above the feed. |
style |
String | No | Global setting | Override the display style for this instance. |
Examples
Section titled “Examples”Display stories with the submission form:
[wb-story-activities form="1"]Display a limited number of stories without the form:
[wb-story-activities count="10"][wb-story-user-stories]
Section titled “[wb-story-user-stories]”Displays stories for a specific user. Supports both individual stories and story collections (public stories with cover images).
Parameters
Section titled “Parameters”| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
id |
Integer | Yes | – | The user ID whose stories to display. |
type |
String | No | single |
Story type: single for individual stories, public for story collections. |
subs |
String | No | – | Comma-separated user IDs to include as additional story sources. |
form |
String | No | enable |
Set to disable to hide the story submission form. |
Examples
Section titled “Examples”Display individual stories for user ID 5:
[wb-story-user-stories id="5"]Display story collections for user ID 5 with the form hidden:
[wb-story-user-stories id="5" type="public" form="disable"]Include stories from multiple users:
[wb-story-user-stories id="5" subs="6,7,8"][wb-user-stories]
Section titled “[wb-user-stories]”A simpler variant for displaying a specific user’s stories. Does not include a submission form.
Parameters
Section titled “Parameters”| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
id |
Integer | No | Current user | The user ID whose stories to display. If omitted, shows the current logged-in user’s stories. |
type |
String | No | single |
Story type: single for individual stories, public for story collections. |
subs |
String | No | – | Comma-separated user IDs to include as additional story sources. |
Examples
Section titled “Examples”Display the current user’s stories:
[wb-user-stories]Display stories for a specific user:
[wb-user-stories id="12"][wp-stories-peepso]
Section titled “[wp-stories-peepso]”Displays the PeepSo activity story stream. This shortcode has no parameters and requires both PeepSo to be active and PeepSo integration to be enabled in the plugin settings.
Example
Section titled “Example”[wp-stories-peepso]If PeepSo is not active or the integration is not enabled, this shortcode outputs nothing.