{
  "category": "Lookup and reference functions",
  "display_name": "HYPERLINK",
  "entry_kind": "built_in_function",
  "eval_api": {
    "method": "POST",
    "url": "https://handbook.dnacalc.com/api/eval"
  },
  "function_id": "FUNC.HYPERLINK",
  "implementation_state": {
    "answer_bank": null,
    "detail": "Recorded: 3 workbook cells.",
    "dnacalc_commit": "9e1884369a678158dd82d3d74188daf986995e87",
    "in_catalogue": true,
    "state": "matches",
    "state_label": "Matches every recorded Excel answer",
    "summary": "Matches all 3 recorded answers",
    "workbook_corpus": {
      "cells": 3,
      "matched": 3
    }
  },
  "implementations": [
    {
      "commit": "9e1884369a678158dd82d3d74188daf986995e87",
      "flavour": "excel-compatibility-candidate",
      "language": "Rust",
      "name": "CalcFunc",
      "own_code": [
        "https://github.com/DnaCalc/DnaCalc/blob/9e1884369a678158dd82d3d74188daf986995e87/crates/calc-func/src/catalogue/text_format.rs#L940-L940",
        "https://github.com/DnaCalc/DnaCalc/blob/9e1884369a678158dd82d3d74188daf986995e87/crates/calc-func/src/catalogue/text_format.rs#L577-L589"
      ],
      "repository": "https://github.com/DnaCalc/DnaCalc",
      "shared_code": [
        "catalogue/text_format::read_value",
        "catalogue/text_format::value",
        "catalogue/text_format::profile",
        "catalogue/text_format::rendered",
        "catalogue/text_format::text",
        "decimal::low32",
        "decimal::Natural::zero",
        "decimal::Natural::from_u64",
        "decimal::Natural::pow10",
        "decimal::Natural::normalize",
        "decimal::Natural::is_zero",
        "decimal::Natural::mul_add_small",
        "decimal::Natural::times_pow10",
        "decimal::Natural::times_pow5",
        "decimal::Natural::times_pow2",
        "decimal::ExactDecimal::read",
        "decimal::ExactDecimal::binary",
        "format/datetime::has_invalid_exponent",
        "format/datetime::looks_like_datetime_format",
        "format/datetime::without_subseconds",
        "format/datetime::render_with_datetime_tokens",
        "format/datetime::tokenize_datetime_format",
        "format/datetime::elapsed_token_at",
        "format/datetime::classify_minute_tokens",
        "format/datetime::token_kind",
        "format/datetime::is_time_neighbor",
        "format/datetime::push_literal",
        "format/datetime::render_datetime_literal",
        "format/datetime::format_elapsed",
        "format/datetime::TimeParts::from_serial",
        "format::measured_host",
        "format::currency_literal",
        "format::digits",
        "format::fifteen",
        "format::split",
        "format::grouped",
        "format::general",
        "format::significant",
        "format::sections",
        "format::bracket",
        "format::is_condition",
        "format::is_elapsed",
        "format::condition_holds",
        "format::condition_of",
        "format::strip_tokens",
        "format::choose",
        "format::items",
        "format::numeric",
        "format::literal_text",
        "format::integer_part",
        "format::fraction_part",
        "format::scientific",
        "format::fraction_code",
        "format::FractionCode::render",
        "format::mixed_fraction_under_space_grouping",
        "format::convergent",
        "format::text_declared_date_locale",
        "format::text",
        "format::text_of_text",
        "format/names::month_name",
        "format/names::weekday_name",
        "format/names::locale_names",
        "locale::LocaleId::from_bcp47_language_tag",
        "locale::LocaleId::from_excel_lcid",
        "locale::short_date_order",
        "locale::short_date_pattern",
        "locale::currency_placement",
        "locale::currency_spacing",
        "locale::currency_negative_pattern",
        "locale::format_profile",
        "locale::days_from_civil",
        "locale::civil_from_days",
        "locale::ymd_from_excel_serial",
        "number_text::decimal",
        "number_text::first_precision",
        "number_text::near_tie",
        "number_text::first_rounding",
        "number_text::rounded",
        "number_text::increment",
        "number_text::ascii",
        "ported/date_kernels::days_from_civil",
        "ported/date_kernels::civil_from_days",
        "ported/date_kernels::serial_unbounded_1900",
        "ported/date_kernels::ymd_1900",
        "ported/date_kernels::is_leap",
        "ported/date_kernels::days_in_month",
        "ported/date_kernels::whole_serial",
        "ported/date_kernels::whole",
        "ported/date_kernels::weekday_sunday_one_based",
        "ported/date_kernels::remap_weekday",
        "ported/date_kernels::weekday_of",
        "ported/date_kernels::weekday",
        "ported/text_kernels::text",
        "ported/text_kernels::text_from_str",
        "ported/text_kernels::date_integer_floor",
        "ported/text_kernels::push_singleton_or_original",
        "ported/text_kernels::push_upper",
        "ported/text_kernels::upper",
        "value_text::measured_host_reader",
        "value_text::measured_space",
        "value_text::read",
        "value_text::number",
        "value_text::decimal",
        "value_text::fraction",
        "value_text::tokens",
        "value_text::month_named",
        "value_text::time_at",
        "value_text::full_year",
        "value_text::valid_day",
        "value_text::this_year",
        "value_text::serial_1900",
        "value_text::date_of",
        "value_text::date_time"
      ],
      "source": "https://github.com/DnaCalc/DnaCalc/blob/9e1884369a678158dd82d3d74188daf986995e87/crates/calc-func/src/catalogue/text_format.rs#L940-L940",
      "state": "matches",
      "suite": null,
      "summary": "Matches all 3 recorded answers"
    }
  ],
  "json_url": "https://handbook.dnacalc.com/api/functions/FUNC.HYPERLINK.json",
  "name": "HYPERLINK",
  "notes": [],
  "schema": "efh.function-reference/v1",
  "section_order": [
    "what-it-does",
    "try-it",
    "quirks",
    "how-to-implement",
    "version-differences",
    "alternatives"
  ],
  "sections": {
    "alternatives": "\n[WEBSERVICE](FUNC.WEBSERVICE.md) retrieves data rather than making a link; [ENCODEURL](FUNC.ENCODEURL.md) encodes text for URL construction.\n\n\n",
    "how-to-implement": "\nPreserve the location and optional label as a host-visible hyperlink result or side channel. Use the location as label when the second argument is omitted, and propagate a supplied label’s worksheet error. A pure-value evaluator can reproduce a label without implementing navigation; report that capability separately. Do not perform an HTTP request simply to evaluate HYPERLINK. Apply the platform’s normal click/navigation behaviour at the host boundary.\n\n\n",
    "quirks": "\nExcel for the web supports URL destinations only. A nonexistent or inaccessible location can fail when the user clicks; that is different from calculating the formula. An error-valued friendly name displays its error. Desktop file paths, workbook fragments and web URLs need distinct host navigation rules.\n\n\n",
    "sources": "\n- [Microsoft: HYPERLINK function](https://support.microsoft.com/en-us/excel/functions/hyperlink-function), opened 6 November 2026; syntax, documented argument rules and errors.\n\n",
    "try-it": "\n`=HYPERLINK(\"https://handbook.dnacalc.com/\",\"Function handbook\")` displays “Function handbook” as the link label. Creating the formula does not mean that the destination has been fetched or that navigation has succeeded.\n\n\n",
    "version-differences": "\nNo same-input comparison between named Excel builds is recorded for this function here. The documented behaviour below is not a measurement of every Excel release.\n\n\n",
    "what-it-does": "\n`HYPERLINK(link_location,[friendly_name])` creates a clickable destination with a displayed label. If no label is supplied the link location is displayed. A destination can be a web URL or a desktop-supported file/workbook location.\n\n\n"
  },
  "signature": {
    "display": "HYPERLINK(link_location, [friendly_name])",
    "parameters": [
      {
        "description": "Target URL or workbook-local hyperlink location.",
        "name": "link_location",
        "optional": false,
        "repeats": false
      },
      {
        "description": "Optional display value carried alongside hyperlink formatting hints.",
        "name": "friendly_name",
        "optional": true,
        "repeats": false
      }
    ],
    "trailing_repeats": false
  },
  "sources": {
    "metadata": {
      "admission": {
        "label": "implemented",
        "reason": null
      },
      "arity": {
        "max": 2,
        "min": 1
      },
      "category": "Lookup and reference functions",
      "classification": {
        "arg_preparation_profile": "ValuesOnlyPreAdapter",
        "coercion_lift_profile": "Custom",
        "determinism_class": "Deterministic",
        "error_collapse_profile": "None",
        "fec_dependency_profile": "Composite",
        "host_interaction_class": "EnvironmentState",
        "kernel_signature_class": "TextToText",
        "rich_value_usage": "ProducesPresentation",
        "surface_fec_dependency_profile": "Composite",
        "thread_safety_class": "HostSerialized",
        "volatility_class": "NonVolatile"
      },
      "descriptions": {
        "long": "The first widened tranche uses HYPERLINK as the presentation-aware value representative.",
        "short": "A clickable link to a document or web address, shown with a label",
        "short_source": "dna-calc-own"
      },
      "docs": {
        "english_description": "Creates a shortcut or jump that opens a document stored on a network server, an intranet, or the Internet",
        "microsoft_url": "https://support.microsoft.com/en-us/office/hyperlink-function-333c7ce6-c5ae-4164-9c47-7de9b76f577f"
      },
      "entry_kind": "built_in_function",
      "localized_family_names": null,
      "localized_names": [
        {
          "locale": "ar-SA",
          "name": "HYPERLINK"
        },
        {
          "locale": "bg-BG",
          "name": "HYPERLINK"
        },
        {
          "locale": "cs-CZ",
          "name": "HYPERTEXTOVÝ.ODKAZ"
        },
        {
          "locale": "da-DK",
          "name": "HYPERLINK"
        },
        {
          "locale": "de-DE",
          "name": "HYPERLINK"
        },
        {
          "locale": "el-GR",
          "name": "HYPERLINK"
        },
        {
          "locale": "en-AU",
          "name": "HYPERLINK"
        },
        {
          "locale": "en-GB",
          "name": "HYPERLINK"
        },
        {
          "locale": "en-US",
          "name": "HYPERLINK"
        },
        {
          "locale": "es-ES",
          "name": "HIPERVÍNCULO"
        },
        {
          "locale": "et-EE",
          "name": "HYPERLINK"
        },
        {
          "locale": "fi-FI",
          "name": "HYPERLINKKI"
        },
        {
          "locale": "fr-FR",
          "name": "LIEN HYPERTEXTE"
        },
        {
          "locale": "he-IL",
          "name": "HYPERLINK"
        },
        {
          "locale": "hr-HR",
          "name": "HYPERLINK"
        },
        {
          "locale": "hu-HU",
          "name": "HIPERHIVATKOZÁS"
        },
        {
          "locale": "id-ID",
          "name": "HYPERLINK"
        },
        {
          "locale": "it-IT",
          "name": "COLLEG.IPERTESTUALE"
        },
        {
          "locale": "ja-JP",
          "name": "HYPERLINK"
        },
        {
          "locale": "ko-KR",
          "name": "HYPERLINK"
        },
        {
          "locale": "lt-LT",
          "name": "HYPERLINK"
        },
        {
          "locale": "lv-LV",
          "name": "HYPERLINK"
        },
        {
          "locale": "nb-NO",
          "name": "HYPERKOBLING"
        },
        {
          "locale": "nl-NL",
          "name": "HYPERLINK"
        },
        {
          "locale": "pl-PL",
          "name": "HIPERŁĄCZE"
        },
        {
          "locale": "pt-BR",
          "name": "HIPERLINK"
        },
        {
          "locale": "pt-PT",
          "name": "HIPERLIGAÇÃO"
        },
        {
          "locale": "ro-RO",
          "name": "HYPERLINK"
        },
        {
          "locale": "ru-RU",
          "name": "ГИПЕРССЫЛКА"
        },
        {
          "locale": "sk-SK",
          "name": "HYPERLINK"
        },
        {
          "locale": "sl-SI",
          "name": "HYPERLINK"
        },
        {
          "locale": "sr-Latn-RS",
          "name": "HYPERLINK"
        },
        {
          "locale": "sv-SE",
          "name": "HYPERLÄNK"
        },
        {
          "locale": "th-TH",
          "name": "HYPERLINK"
        },
        {
          "locale": "tr-TR",
          "name": "KÖPRÜ"
        },
        {
          "locale": "uk-UA",
          "name": "HYPERLINK"
        },
        {
          "locale": "vi-VN",
          "name": "HYPERLINK"
        },
        {
          "locale": "zh-CN",
          "name": "HYPERLINK"
        },
        {
          "locale": "zh-HK",
          "name": "HYPERLINK"
        },
        {
          "locale": "zh-TW",
          "name": "HYPERLINK"
        }
      ],
      "signature": {
        "display": "HYPERLINK(link_location, [friendly_name])",
        "parameters": [
          {
            "description": "Target URL or workbook-local hyperlink location.",
            "name": "link_location",
            "optional": false,
            "repeats": false
          },
          {
            "description": "Optional display value carried alongside hyperlink formatting hints.",
            "name": "friendly_name",
            "optional": true,
            "repeats": false
          }
        ],
        "trailing_repeats": false
      },
      "surface_name": "HYPERLINK",
      "version_marker": null,
      "xlcall": {
        "code": "359",
        "symbol": "xlfHyperlink"
      }
    },
    "microsoft": "https://support.microsoft.com/en-us/office/hyperlink-function-333c7ce6-c5ae-4164-9c47-7de9b76f577f"
  },
  "try_it": {
    "formula": "=HYPERLINK(\"https://handbook.dnacalc.com/\",\"Function handbook\")"
  },
  "url": "https://handbook.dnacalc.com/functions/HYPERLINK.html",
  "variants": [],
  "versions": []
}