Back to protocols

Testing URI Protocols

Learn how to test deep links directly from Schemata and understand what happens when you click "Test".

How Protocol Testing Works

1. Click the "Test" Button

Each command example has a "Test" button. Clicking it attempts to open the protocol using your system's default handler.

2. Browser Security Prompt

Your browser will ask for permission to open the external application. This is a security feature to prevent malicious sites from launching apps without your consent.

3. System Handler Opens

If the application is installed on your system, it will launch with the specified parameters. For example, steam://run/730 will launch Counter-Strike 2 if you have Steam installed.

Common Testing Scenarios

Protocol Works

The application launches successfully with the correct parameters.

Example:
spotify:track:3n3Ppam7vgaVa1iaRUc9Lp
→ Spotify opens and plays the track

App Not Installed

The browser shows an error or does nothing because the application isn't installed.

Example:
roblox://experiences/start?placeId=123
→ Browser: "No app to handle roblox://"

Platform Mismatch

The protocol might not be supported on your current platform (e.g., testing an iOS-only protocol on Windows).

Check platform badges:
🪟 Windows 🍎 macOS 🐧 Linux
📱 iOS 🤖 Android

Browser Security

Some browsers require explicit permission to launch external protocols. Check your browser settings if protocols never open.

Tip: Look for permission prompts at the top of the browser window.

Safety & Best Practices

Test Protocols Safely

  • All examples in Schemata use safe, publicly documented parameters
  • Testing will only launch applications you already have installed
  • Your browser will always ask for permission before launching external apps
  • If unsure, copy the URI first and inspect it before testing

Debugging Failed Tests

  1. Verify the application is installed on your system
  2. Check if the protocol is supported on your platform (see badges)
  3. Ensure your browser allows external protocol handlers
  4. Try copying the URI and pasting it directly in your browser's address bar
  5. Check the application's documentation for any required setup

Ready to Test?

Head back to the protocols list and try testing some deep links!

Browse Protocols