Linking Between Pages
This guide covers how to link between pages in a Gatsby site.
<Link /> component is for linking between pages within your site. For external links to pages not handled by your Gatsby site, use the regular HTML
Here’s an example of creating a link between two pages in a Gatsby site.
Open a page component (e.g.
src/pages/index.js) in your Gatsby site. Import the
Link component from Gatsby, which makes it available in the component. Add a
<Link /> component below the header, and give it a
to property with the value of
"/contact/" for the pathname:
The above code will add a link to the contact page, automatically rendered in HTML as
<a href="/contact/"> but with added performance benefits. The link’s value is based off of the page’s filename which in this case would be
Note: the value
toproperty will take users to the home page.
If you are linking to pages not handled by your Gatsby site (such as on a different domain), you should use the native HTML
<a> tag instead of Gatsby Link.
Additionally, if you wish to have an external link open in new window using the
target attribute, use the
It is also recommended to include a visual icon or some kind of indicator differentiating external links from internal ones.
- For the complete example of how to link between pages, see Part One in the Tutorial
- Check out more detail on routing in Gatsby in the API doc for Gatsby Link.
Edit this page on GitHub