Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add seo docs #4766

Merged
merged 5 commits into from
Mar 30, 2018
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
26 changes: 26 additions & 0 deletions docs/docs/seo.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,26 @@
# SEO with Gatsby

Gatsby helps your site place better in search engines. Some advantages come out of the box and some require configuration.

### Server rendering

Because Gatsby pages are server-rendered, rather than client-rendered, all the page content is available to Google and other search engines or crawlers.

(You can see this by viewing the source for this page).

### Speed boost

Gatsby's many built-in performance optimizations, such as rendering to static files, progressive image loading, and the PRPL pattern—all help your site be lightning-fast by default.

Starting in January 2018, Google [rewards faster sites with a bump in search rankings](https://searchengineland.com/google-speed-update-page-speed-will-become-ranking-factor-mobile-search-289904).

### Page metadata

Add metadata to pages, such as page title and description, helps search engines understand your content and when to show your pages in search results.

A common way to add metadata to pages is to add [react-helmet](https://github.com/nfl/react-helmet) components (together with the [Gatsby React Helmet plugin](/packages/gatsby-plugin-react-helmet) for SSR support) to your page components.

Some examples using react-helmet:
* [Official GatsbyJS.org site](https://github.com/gatsbyjs/gatsby/blob/master/www/src/layouts/index.js)
* [Jason Lengstorf's personal website](https://github.com/jlengstorf/lengstorf.com/blob/master/src/components/SEO.js)

2 changes: 2 additions & 0 deletions www/src/pages/docs/doc-links.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -64,6 +64,8 @@
link: /docs/plugin-authoring/
- title: Proxying API Requests
link: /docs/api-proxy/
- title: Search Engine Optimization (SEO)
link: /docs/seo/
- title: Using CSS-in-JS Library Glamor
link: /docs/glamor/
- title: Using CSS-in-JS Library Styled Components
Expand Down