Home | Tips | Library | Other Authors | Other WP Sites | Writer's Links | Contact | Site Map | Donate

Barry MacDonnell's
Toolbox for WordPerfect

Macros, tips, and templates for Corel® WordPerfect® for Windows®
© Copyright 1996-2019 by Barry MacDonnell. All Rights Reserved.

Page updated Jul 21, 2017

WordPerfect Tips
Main tips page | Browse tips
Why some hyperlinks (hypertext links) can fail to work while inside WordPerfect documents (.wpd, .wpt)

Related pages:

•  To create a hyperlink from a word/phrase/symbol to some other part of the current document, to another local document, to a web site, or to a macro see How to create hyperlinks (hypertext links) in WordPerfect [includes some tips if the document is to be Published to PDF]

Here are some reasons why they might fail (or appear to fail) -- that is, the mouse cursor does not turn into a finger-pointing cursor Finger pointer when directly on a hyperlink -- when you are navigating in a hyperlinked WordPerfect document (i.e., not navigating in a PDF document).

•  The activation state (on or off) for hyperlinks is stored with the document when it is saved to disk.

The stored state will take precedence over the current state of the Tools, Settings, Environment, "Activate Hyperlinks" checkbox.

Therefore, even if you have enabled that checkbox option, the current document's settings might be over-riding it. (See the next item's Hyperlink Toggle, which you can use to re-activate hyperlinks in the document.)

Note that you can still create hyperlinks even if the activation state is turned Off. Further, if you use Publish to PDF any hyperlinks in that PDF will still be active regardless of the activation state in the WordPerfect document.

•  Using the Hyperlink Property Bar.

Hyperlink Property Bar
If you have edited a hyperlink by right-clicking it and choosing Edit Hyperlink, the Hyperlink Property Bar above will (or might) have appeared. (It might also appear if the Shadow Cursor is enabled; see below.)

The finger-pointing icon on that property bar is a Hyperlink Toggle. (Here, it is shown activated.)

Alternative: You can calso display the Hyperlink Toolbar:
Hyperlink Toolbar
Right-click on WordPerfect's toolbar area and choose Hyperlink Tools. Or use View, Toolbars and choose it from the Toolbars dialog.

This toolbar is similar to the Hyperlink Property Bar above, so it also has the Hyperlink Toggle button.

Either way, if you then click the Hyperlink Toggle button (accidentally or on purpose) it will turn activation off (if it was on) -- and this state will be stored with the document when it is saved, regardless of the current state of the Tools, Settings, Environment, "Activate Hyperlinks" checkbox. (The latter is a global, user-preference setting.)

Hence, if you turned it off and you then saved the document, the hyperlinks won't work when you open the document again, until you reactivate the setting.


The Hyperlink toolbar's left-most button is the Hyperlink Return, a useful button that takes you back to the initial hyperlinked bookmark in the WordPerfect document.

•  Hyperlinks to web sites can fail if you have set a firewall program to block WordPerfect's access to the Internet. (See also the cross reference tip below.)

•  If you use the Shadow Cursor (View, Shadow Cursor) and you have set it to anything other than "Active in White Space" (in Tools, Settings, Display, Document [tab]), the Shadow Cursor will only operate the hyperlink at the end of the hyperlink, not at any point before the end of the hyperlink. [For some general information on the Shadow Cursor see here.)

•  If the location of the bookmark to which the hyperlink points is on the same screen (perhaps just a few sentences away), the cursor might move there but the screen might not move, giving the illusion that nothing has happened. (Check Reveal Codes to see if the cursor has moved.)

•  If a hyperlinked cross reference to a target takes you somewhere else:

That is, if clicking on the cross reference number does not take you to its target, but instead it activates an immediately preceding hyperlink (possibly with intervening text) to an external document (e.g., a PDF file) or a web address (URL), then you might have come upon abug which has existed since WordPerfect 9 (and is still present in at least WPX6 as of November 2013).

In Reveal Codes these items might look like the following example, where "sample file" is text that is hyperlinked to a PDF file on disk; [Ref Pg] is the cross reference that displays a number; "lorem ipsum" is some more text on the next page; and [Target] is the cross reference's target location:

[Hyperlink]sample file[Hyperlink][HRt]
[Ref Pg][HPg]
lorem ipsum[HRt]

There's a workaround (a small macro) posted on WordPerfect Universe by Roy "lemoto" Lewis here (the last macro in the thread is the most recent one).

"The macro is a workaround. After every URL link, it inserts a Bookmark and a hyperlink to that Bookmark. Thus no crossref. hyperlink can be [immediately] preceded by a URL hyperlink. ..."