URL Schemes

||

This page covers the URL schemes you can use to deep-link from your HTML5 app to files, Experiences, folders, and Showpad Video, along with the parameters that control how content opens.

What you'll learn

• How to construct URL schemes for different content types
• How to find file, folder, and Experience IDs
• How to control navigation behavior with parameters

TL;DR

• Open a file? Use showpad://file/[file-id]
• Open an Experience? Use showpad://profile/[profile-id]
• Open file in specific folder? Use showpad://folder/[folder-id]/file/[file-id]
• Stay in current context? Add ?modal=1 to return to original location when closed

URL scheme reference

Scheme	Description	Parameters
showpad://file/[file-id]	Opens the specified file. If the file is in another Experience, navigates to that Experience (unless modal=1 is set). If the file exists in multiple Experiences, the app searches the current Experience first.	page, modal
showpad://profile/[profile-id]	Opens the specified Experience.	-
showpad://video	Opens Showpad Video to record a video message.	-
showpad://folder/[folder-id]/file/[file-id]	Opens a file within a specific folder. Adding modal=1 returns the user to the original context when the file is closed.	page, modal

Find content IDs

Build URL schemes by retrieving the unique ID for files, Pages, or Experiences.

File ID

1. Open the Files library in Showpad.
2. Click a file to open its detail panel.
3. In the Overview section, click the copy icon next to File link.
4. Extract the ID from the URL:

https://myorganization.showpad.biz/app/asset/395d5806-e691-4f21-acfa-bcd98a2a386f
                                              └──────────────── file-id ────────────────┘

To find a Page ID, follow the same steps in the Pages library.

Experience ID

1. Open the Experiences library in Showpad.
2. Click an Experience to open its detail panel.
3. Copy the App link from the Overview section: this is the complete URL scheme (e.g., showpad://profile/572).

Parameters

Control how content opens with optional query parameters.

Parameter	Type	Default	Description
page	integer	1	Opens a specific page in a PDF or positions within a folder. 1-based index.
modal	boolean	0	When 1, opens content as an overlay. Closing returns the user to the original context.

When to use modal

Content location	Recommended	Result
Another Classic folder	modal=0	Navigate to the target folder
On a Page	modal=0	Navigate to the Page's folder
Within an Advanced Experience	modal=1	Return to the original context on close

Examples

Open a file

showpad://file/78548788556b599d4977a7d58f70aa84

Open a PDF to page 5 in modal mode

showpad://file/78548788556b599d4977a7d58f70aa84?modal=1&page=5

Open a file in a specific folder

showpad://folder/abc123def456/file/78548788556b599d4977a7d58f70aa84

Open an Experience

showpad://profile/my-experience-id

Launch Showpad Video

showpad://video

Next steps

• SDK Integration - Trigger Showpad functionality from your HTML5 app
• Image Placeholders - Display user and content images dynamically
• Prefill Shares - Pre-populate share dialogs with content