{"title":"System.Hyperlink(Text) Method","url":"https://jonas-paprotka.de/docs/dev-itpro/developer/methods-auto/system/system-hyperlink-method/","by":"JOP-AL","license":"Copyright (c) Microsoft Corporation. CC BY 4.0, https://creativecommons.org/licenses/by/4.0/; code samples MIT. From https://learn.microsoft.com/en-us/dynamics365/business-central/dev-itpro/developer/methods-auto/system/system-hyperlink-method, MicrosoftDocs/dynamics365smb-devitpro-pb at 828b6ee (2026-11-19). Changed: includes filled in, links to this site, and for agents shortened without dropping a fact.","credit":"Microsoft Corporation, CC BY 4.0","origin":"https://learn.microsoft.com/en-us/dynamics365/business-central/dev-itpro/developer/methods-auto/system/system-hyperlink-method","source":{"name":"Business Central developer and IT pro docs","repo":"https://github.com/MicrosoftDocs/dynamics365smb-devitpro-pb","commit":"828b6ee72fcd75755627cd6011f3d20899217ab2","date":"2026-11-19"},"checked":"2026-11-19","description":"Passes a URL as an argument to an Internet browser, such as Microsoft Edge.","date":"2026-10-01","meta":{"topic":"reference"},"outline":[{"level":1,"title":"System.Hyperlink(Text) Method","slug":"systemhyperlinktext-method","at":0,"chars":2204},{"level":2,"title":"Syntax","slug":"syntax","at":168,"chars":124},{"level":2,"title":"Parameters","slug":"parameters","at":292,"chars":108},{"level":2,"title":"Remarks","slug":"remarks","at":400,"chars":1305},{"level":3,"title":"Restrictions","slug":"restrictions","at":1227,"chars":478},{"level":2,"title":"Example","slug":"example","at":1705,"chars":365},{"level":2,"title":"Related information","slug":"related-information","at":2070,"chars":134}],"text":"# System.Hyperlink(Text) Method\n> Version: _Available or changed with runtime version 1.0._\nPasses a URL as an argument to an Internet browser, such as Microsoft Edge.\n## Syntax\n```al\n System.Hyperlink(URL: Text)\n```\n> NOTE\n> This method can be invoked without specifying the data type name.\n## Parameters\nURL\nType: ../text/text-data-type\nA URL that is passed to the Internet browser as an argument.\n## Remarks\nThe syntax must be a valid URL, such as https://www.microsoft.com, or path to a file on file share, such as file://d$/myfiles/myfile.txt. If you want the URL to be configurable, you can get the URL from a field or a variable instead. If you pass an empty string, then no browser window is opened.\nAt runtime, a new tab is opened in the same browser window where Dynamics 365 Business Central is running.\nThe HyperLink method works with different protocols and file types as along as the syntax is valid.\n> NOTE\n> When using the file:// protocol to open a file, the file should be stored on a network file share, not locally; otherwise the file doesn't open. Browsers block hyperlinks to files from a web page for security reasons and the hyperlink must be manually copied and pasted into a manually opened tab page.\n### Restrictions\n Security enhancements restrict hyperlinks in Business Central online environments. Only IP addresses that are DNS-resolvable or that are in the RFC 1918 private address space are permitted. HTTP links are not supported - use HTTPS for all links. Noncompliant links are not executed and users see a warning dialog.\n Protocols such as file:// and ftp:// remain supported where the environment allows them.\n The HyperLink method is not supported on NAS services.\n## Example\nThe following example shows two uses of the HyperLink method to open the specified URL in the default browser. In the first line of code, the URL is specified in code. The second line of code illustrates how you can get a URL that is stored in a field on the current table.\n```al\nHyperLink('https://www.microsoft.com');\n...\nHyperLink(Rec.UrlField);\n\n```\n## Related information\nsystem-data-type\nGet Started with AL<../../devenv-get-started>\nDeveloping Extensions<../../devenv-dev-overview>"}