How to Make Bluebeam Open Links in a Browser

Bluebeam Revu is a powerful PDF tool built for construction, engineering, and design workflows — but its default behavior of handling hyperlinks internally can catch users off guard. If you've clicked a URL embedded in a PDF and found it opening inside Bluebeam instead of your browser, you're not alone. Here's what's actually happening, why it works that way, and what controls the outcome.

Why Bluebeam Handles Links Internally by Default

Bluebeam Revu is designed to keep users inside its environment as much as possible. When a PDF contains a hyperlink — whether to a website, a cloud-hosted document, or an external file — Revu's default behavior is to process that link within the application rather than hand it off to the operating system.

This is partly intentional. In project-based workflows, many links inside PDFs point to other PDFs or internal file paths, not public web URLs. Bluebeam's internal handler keeps those references working consistently across different machines and network configurations. The side effect is that external web URLs sometimes get treated the same way, opening in a limited internal viewer or triggering unexpected behavior instead of launching your default browser.

How to Change Bluebeam's Link Behavior

The most direct fix lives inside Bluebeam's Preferences panel.

Step 1: Open Preferences

Go to Edit → Preferences (on Windows) or use the keyboard shortcut Ctrl + K. This opens the full settings panel.

Step 2: Navigate to the General Tab

Inside Preferences, select the General category from the left-hand panel. This is where core application behavior is configured.

Step 3: Find the Hyperlink Setting

Look for an option related to hyperlink behavior or open links in external browser. Depending on your version of Bluebeam Revu, this may be labeled:

  • "Open web links in default browser"
  • "Use system browser for URLs"
  • A checkbox or dropdown under the Web or Links section

Enable that setting, apply, and restart Bluebeam if prompted.

When the Link Still Opens Inside Bluebeam

Even with browser preferences adjusted, certain link types may still behave differently. A few factors drive this:

Link type matters. A PDF hyperlink can be encoded in different ways — as a web action (URI action), a file launch action, or a named destination. URI actions pointing to http:// or https:// addresses are most likely to respect the "open in browser" preference. Other link types, like relative file paths or JavaScript-based actions, may not.

PDF author settings. Some PDFs are built with embedded actions that override viewer preferences. If a document was created with specific open actions configured, Bluebeam — like any PDF reader — may follow those instructions regardless of your default settings.

Bluebeam version differences. The behavior between Revu Standard, CAD, and eXtreme editions, and between older perpetual license versions versus the current subscription model, isn't always identical. Features and preference labels have shifted across major releases.

System-Level Factors That Affect This

Even when Bluebeam is configured correctly, your operating system plays a role. 🖥️

  • Default browser setting in Windows: Bluebeam passes the URL to Windows' default browser handler. If your default browser isn't set correctly in Windows Settings (Settings → Apps → Default Apps), the link may open in the wrong browser or fail entirely.
  • Security software or network policies: In enterprise environments, IT-managed policies can restrict how applications interact with browsers. If you're on a corporate machine, this setting may be locked or overridden at the policy level.
  • Revu in a Citrix or virtual desktop environment: Virtualized deployments of Bluebeam can break the handoff between the application and the local browser, since the "local" browser may not be accessible from inside the virtual session.

The Difference Between Embedded Links and Attachment Links

It's worth understanding that not everything that looks like a clickable link in a PDF behaves the same way.

Link TypeTypical BehaviorBrowser Involved?
URI hyperlink (http/https)Opens web URLYes, if preference is set
File path linkOpens local or network fileNo — file handler
PDF page linkJumps to page within PDFNo — internal navigation
Email link (mailto:)Opens email clientNo — mail handler
Embedded attachmentOpens attachment viewerDepends on file type

Understanding which type of link is in your document helps diagnose why a specific link isn't behaving as expected even after you've updated your preferences.

What Changes Between Users

The same preference setting in Bluebeam produces different results depending on a handful of variables: which edition and version of Revu is installed, how Windows is configured, whether the machine is personally managed or IT-controlled, and how the original PDF was built. A user on a standalone workstation running Revu 21 with full admin rights has a very different range of options than someone accessing Bluebeam through a managed enterprise deployment.

That gap — between the general setting and whether it actually works the way you expect — usually comes down to your specific combination of those factors. 🔍