DeskPress provides 7 shortcodes you can use on any WordPress page or post. Just paste the shortcode into your content editor -- no coding required!
1. [helpscout_desk] -- Conversation List
Displays the current user's Help Scout conversations with status filters.
| Attribute | Default | Description |
|---|---|---|
| mid | (none) | Optional mailbox ID to filter conversations |
Examples:
[helpscout_desk]
[helpscout_desk mid="12345"]Requires: Pro license. The user must be logged in.
Related: Conversations
2. [hsd_form] -- Support Form
Renders a contact form that creates Help Scout conversations.
| Attribute | Default | Description |
|---|---|---|
| mid | (none) | Mailbox ID override |
| form | default | Form Builder slug |
| collection_id | (none) | Docs collection ID for inline article search |
Examples:
[hsd_form]
[hsd_form mid="12345" collection_id="abc123"]Guest users see an email capture form first. Supports file attachments (JPEG, PNG, GIF, WEBP, PDF, TXT, DOC, DOCX, XLS, XLSX -- max 5 MB each).
Related: Support Form
3. [hsd_chatbot] -- AI Chatbot
Embeds the AI chatbot inline on any page.
| Attribute | Default | Description |
|---|---|---|
| height | From settings | Panel height in pixels (min: 200) |
| show_tickets | From settings | Show Tickets tab -- "0" to hide |
| show_docs | From settings | Show Docs tab -- "0" to hide |
Examples:
[hsd_chatbot]
[hsd_chatbot height="600" show_tickets="1" show_docs="1"]Requires: Pro license. AI must be configured and the knowledge base indexed. The chatbot can also appear as a floating bubble (configured in settings).
Related: AI Chatbot
4. [hsd_docs] -- Docs Browser
Renders a full documentation browser with search and optional topic categories.
| Attribute | Default | Description |
|---|---|---|
| collection_id | (none) | Help Scout Docs collection ID |
| placeholder | "Search documentation..." | Search input placeholder text |
| show_topics | "true" | Show topic category cards |
Examples:
[hsd_docs]
[hsd_docs collection_id="abc123" show_topics="false"]Requires: Docs API key configured.
Related: Docs Search
5. [hsd_docs_search] -- Docs Search
Renders a standalone documentation search input.
| Attribute | Default | Description |
|---|---|---|
| collection_id | (none) | Help Scout Docs collection ID |
| placeholder | "Search documentation..." | Input placeholder text |
Examples:
[hsd_docs_search]
[hsd_docs_search placeholder="How can we help?"]Requires: Docs API key configured.
Related: Docs Search
6. [hsd_opening_hours] -- Opening Hours
Displays your support team's business hours and open/closed status.
| Attribute | Default | Description |
|---|---|---|
| show_status | From settings | Show the open/closed status badge (true/false) |
| show_schedule | From settings | Show the full weekly schedule (true/false) |
Examples:
[hsd_opening_hours]
[hsd_opening_hours show_status="true" show_schedule="false"]Requires: Opening Hours enabled in settings.
Related: Opening Hours
7. [hsd_thread] -- Conversation Embed
Embeds a single Help Scout conversation thread.
| Attribute | Required | Default | Description |
|---|---|---|---|
| id | Yes | -- | Help Scout conversation ID |
| mid | No | (none) | Mailbox ID |
Examples:
[hsd_thread id="123456"]
[hsd_thread id="123456" mid="789"]Related: Conversation Embeds
Tips
- Works everywhere. Shortcodes work in pages, posts, text widgets, and most page builders.
- Mix and match. Combine multiple shortcodes on one page to create a custom support layout.
- Using Elementor? Use the dedicated DeskPress widgets instead -- they include full style controls.
- Portal compatibility. All shortcodes are compatible with the portal page templates.