URLs and Email Addresses

URLs that begin with one of the common schemes (https, ftp, irc, mailto, or any email address) are turned into links automatically. You can specify the link text in square brackets immediately after the URL.

Don’t use URLs or system paths to link between PAMMS documents or link to section headings or other elements in a page on the PAMMS site. Document-to-document links are created with cross references to ensure domain, component, and page portability.

Insert a URL to an external site

To create a link to a URL that isn’t part of the PAMMS site, enter the URL preceded by its scheme (i.e. https://). URLS with a recognized scheme will automatically be turned into an active link when published to the site.

To apply to register to vote where you live now, visit https://www.sos.ga.gov/.

The SAVE E-Mail address is SAVE.help@uscis.dhs.gov.

The example above is published as:

To apply to register to vote where you live now, visit www.sos.ga.gov/.

To have text displayed as a link instead of the URL, enter the URL and directly follow it with the link text is a set of square brackets.

To apply to register to vote where you live now, visit https://www.sos.ga.gov/[SOS].

The example above is published as:

To apply to register to vote where you live now, visit SOS.

Email addresses

Email addresses are automatically recognized and converted to active links when the site is published.

The SAVE E-Mail address is SAVE.help@uscis.dhs.gov.

The example above is published as:

The SAVE E-Mail address is SAVE.help@uscis.dhs.gov.

URL best practices

  • Always use the secure https:// scheme for external webpage links.

  • Escape http://localhost URLs in regular text so they don’t become links.

  • Create attributes for long URLs to improve the source readability for other contributors.

  • Create attributes for URLs that contain sets of symbols, such as multiple underscores (_) and backticks (`), that could be misinterpreted as inline markup.

  • Create attributes for URLs used several times on the same page.

  • Don’t use URLs for linking between policy documents or to in-document anchors.