Contact

HYPERLINK Function (OpenOffice Calc)

Lookup Intermediate OpenOffice Calc

Build OpenOffice Calc hyperlink formulas with a target and optional label. Understand text, numeric and empty labels without confusing display values with destinations.

Verification status: 8 source-derived formula patterns were checked against Apache OpenOffice 4.1.16 registration, argument descriptions and the complete callback. No hyperlinks were opened and no native examples were executed. How formula examples are checked

Quick answer: HYPERLINK stores a target and an optional visible label. Omitting the label uses the URL itself. The examples below describe the inspected result construction; no links were opened.

Availability and version history

  • Introduced: First release not established; documented by OpenOffice.org 3.3.
  • Supported in: Registered and implemented in Apache OpenOffice 4.1.16. No retirement is established.
  • Scope: Desktop Calc with English semicolon-separated formulas. The described behavior is tied to the inspected version.
  • Checked: October 14, 2026. Function-specific source and documentation were inspected. No target was opened. No native example is claimed.

The destination and the displayed cell value are separate. A friendly label can hide a long URL, but it does not change where the link leads. The official guide describes opening the hyperlink when its cell is clicked; click behavior, browser integration and target availability were not tested here.

Syntax and arguments

HYPERLINK(URL[; CellText])

Square brackets mark optional arguments; do not type them. URL supplies the destination as text or through a cell containing text. CellText is optional. The inspected callback preserves a text label as text and a numeric label as a number. A reference to a truly empty label cell follows a zero-valued path, while an explicit empty string remains an empty string. Versioned argument description.

Source-derived examples

These examples explain the inspected code and documented contract. They were not executed. The reserved example.invalid URLs are placeholders and were not activated.

Formula or pattern Source-derived interpretation Important context
=HYPERLINK("https://example.invalid/report") Text: https://example.invalid/report Label omitted; the target becomes the displayed value.
=HYPERLINK("https://example.invalid/report";"Report") Text: Report The target and label differ.
=HYPERLINK("https://example.invalid/report";42) Number: 42 Numeric label retained as numeric.
=HYPERLINK("https://example.invalid/report";0) Number: 0 Explicit numeric zero label.
=HYPERLINK("https://example.invalid/report";"") Empty text An explicit empty string is not a blank reference.
=HYPERLINK(A2;B2) Text: Quarterly report A2 contains the example URL; B2 contains this label.
=HYPERLINK(A2;C2) Number: 125 C2 contains numeric 125.
=HYPERLINK(A2;D2) Number: 0 D2 is genuinely empty; source-derived label behavior.

Practical worksheet

For the last three examples, put the literal text https://example.invalid/report in A2, Quarterly report in B2 and numeric 125 in C2; leave D2 genuinely empty. The .invalid destination is an inert documentation placeholder and is not a working report address.

Keeping destination and label in separate columns makes a link list easier to audit. A row labelled Quarterly report should still be checked against its stored destination before anyone follows it. A readable label does not authenticate a site or make a file trustworthy.

If a label should disappear when a source field is empty, supply an explicit empty string deliberately rather than assuming a blank referenced cell has the same result. The two paths are distinct in the inspected callback.

Advanced interpretation and checks

Internally, the callback constructs a one-column, two-row matrix. Its first entry holds the visible label value and its second entry holds the URL. That implementation detail explains how Calc can retain a numeric display value separately from the destination; it is not an instruction to enter HYPERLINK as a two-cell array.

For a referenced label, the source checks empty data, errors, numeric data and text. A referenced error is carried into the result rather than silently becoming a harmless label. A missing optional argument supplied through an explicit missing-argument token also follows a numeric-zero path, whereas omitting the second argument entirely uses the URL.

A destination assembled with CONCATENATE is still just text until used as a link target. Check the completed string for unwanted spaces, separators and parameters. Constructing a plausible-looking URL does not verify that the destination exists or is safe. Inspected callback.

Boundaries and troubleshooting

Exactly one or two arguments are accepted. The guide’s table gives source-derived label values and types, not screenshots or observed cell rendering. Number formatting can affect the visible representation of a numeric label.

No external target was opened. Download behavior, local-file handling, browser choice, authentication and access permissions are outside this review. A hyperlink is also distinct from DDE: HYPERLINK identifies a destination for navigation, while DDE requests linked data from another application.

If a label is misleading or a target is unexpected, inspect the formula or the source cells before activating it. Do not rely on the visible wording alone.

Official evidence and checking scope

The review covers the documented syntax and exact retained 4.1.16 implementation. Navigation, browser handling and actual cell rendering were not tested.