Skip to main content

Autolinked references and URLs

References to URLs, issues, pull requests, and commits are automatically shortened and converted into links.

Who can use this feature?

Markdown can be used in the GitHub web interface.

URLs

GitHub automatically creates links from standard URLs.

Visit https://github.com

Screenshot of rendered GitHub Markdown showing how a URL beginning with "http" becomes as a blue clickable link. The text reads, "Visit https://github.com."

For more information on creating links, see "Basic writing and formatting syntax."

Issues and pull requests

Within conversations on GitHub, references to issues and pull requests are automatically converted to shortened links.

Note

Autolinked references are not created in wikis or files in a repository.

Reference typeRaw referenceShort link
Issue or pull request URLhttps://github.com/jlord/sheetsee.js/issues/26#26
# and issue or pull request number#26#26
GH- and issue or pull request numberGH-26GH-26
Username/Repository# and issue or pull request numberjlord/sheetsee.js#26jlord/sheetsee.js#26
Organization_name/Repository# and issue or pull request numbergithub-linguist/linguist#4039github-linguist/linguist#4039

If you reference an issue, pull request, or discussion in a list, the reference will unfurl to show the title and state instead. For more information about task lists, see "About task lists."

Labels

When referencing the URL of a label in Markdown, the label is automatically rendered. Only labels of the same repository are rendered, URLs pointing to a label from a different repository are rendered as any URL.

The URL of a label can be found by navigating to the labels page and clicking on a label. For example, the URL of the label "enhancement" in our public docs repository is

https://github.com/github/docs/labels/enhancement

Note

If the label name contains a period (.), the label will not automatically render from the label URL.

Commit SHAs

References to a commit's SHA hash are automatically converted into shortened links to the commit on GitHub.

Reference typeRaw referenceShort link
Commit URLhttps://github.com/jlord/sheetsee.js/commit/a5c3785ed8d6a35868bc169f07e40e889087fd2ea5c3785
SHAa5c3785ed8d6a35868bc169f07e40e889087fd2ea5c3785
User@SHAjlord@a5c3785ed8d6a35868bc169f07e40e889087fd2ejlord@a5c3785
Username/Repository@SHAjlord/sheetsee.js@a5c3785ed8d6a35868bc169f07e40e889087fd2ejlord/sheetsee.js@a5c3785

Troubleshooting referencing commit SHAs

When referencing a commit from a private repository inside of a commit message, the commit SHA will only be shortlinked if at least one of the authors or committers of the commit have at least read access to the referenced commit.

If custom autolink references are configured for a repository, then references to external resources, like a JIRA issue or Zendesk ticket, convert into shortened links. To know which autolinks are available in your repository, contact someone with admin permissions to the repository. For more information, see "Configuring autolinks to reference external resources."

Further reading