{"data":{"markdownRemark":{"html":"<p><span style=\"text-align: center; display: block;\">Part of <a href=\"/gatsby-v2\">a series on Gatsby v2</a></span></p>\n<p>Gatsby v2 is out. It's in beta. It <a href=\"/whats-new-in-gatsby-v2\">contains some sweetness</a>. You want it. The big question is, when? Upgrade now? Wait for a final release?</p>\n<blockquote>\n<p><strong>tl;dr</strong> - Upgrade now if you need v2 features. Wait if you don't.</p>\n</blockquote>\n<h2>Intro</h2>\n<p>You can read more about <a href=\"/whats-new-in-gatsby-v2\">what's new in Gatsby v2 here</a>. If you have a large site (1k+ pages) then v2 is a big win right now. If your site is slow to rebuild during development, and you're actively working on it, v2 could be a win.</p>\n<p>Otherwise, v2 is still in a state of flux. The APIs should now be more or less fixed. With the switch from alpha releases to beta releases, some stability has arrived. However, it's still very much the bleeding edge.</p>\n<p>If you don't need any of that new magic, then we recommend waiting. At some point the upgrade will be required, but not necessarily right now. Let other people figure out the issues, let v2 stabilise and improve, and then upgrade. That's the smart advice for a site which is running fine today.</p>\n<h2>v1 forever?</h2>\n<p>Gatsby builds static sites from dynamic content. This removes much of the security problems associated with dynamic sites. If your site runs smoothly on v1, and you don't need anything new, then you may never need to upgrade. At least not in the near future.</p>\n<p>Unless you are actively working on the code of a site, then v1 should continue to work smoothly for years to come.</p>\n<p>There are advantages to v2, but you should not feel compelled to upgrade. It's probably a good idea at some point, but no need to rush into it immediately.</p>\n<h2>Upgrade process</h2>\n<p>The longer you wait, the smoother the process will be. As more people go through the upgrade, it will get easier. More people will write about it. More of the common issues will be documented. The docs will be improved.</p>\n<p>If you upgrade 6 months after the first production release of Gatsby v2, it will be much easier than upgrading today.</p>\n<h2>Conclusion</h2>\n<p>If you don't have a compelling reason to upgrade, don't. In this case, laziness is your friend. Wait as long as you can. Let the process get smoother. Let other people solve the common problems. :-)</p>","excerpt":"Part of  a series on Gatsby v2 Gatsby v2 is out. It's in beta. It  contains some sweetness . You want it. The big question is, when? Upgrade…","timeToRead":2,"frontmatter":{"date":"July 22, 2018","path":"/when-should-i-upgrade-to-gatsby-v2","title":"When should I upgrade to Gatsby v2?"}},"relatedPosts":{"edges":[{"node":{"id":"88e68246-cc05-58c4-9cb0-9fa48bc65259","frontmatter":{"title":"Gatsby v2 refactoring cheat sheet","path":"/gatsby-v2-refactoring-cheat-sheet","tags":["v2","cheat sheet"]}}},{"node":{"id":"1aef1790-d364-5a28-ade8-d6196727902c","frontmatter":{"title":"Getting started with Gatsby v2","path":"/getting-started-with-gatsby-v2","tags":["v2"]}}},{"node":{"id":"c8ef7f7d-dffc-5aae-b6a0-0084762b39f0","frontmatter":{"title":"Gatsby v2","path":"/gatsby-v2","tags":["v2","beta"]}}},{"node":{"id":"43eb2d0b-dabd-5c3d-8f96-41eeffd1c003","frontmatter":{"title":"How do layouts work in Gatsby v2","path":"/how-do-layouts-work-in-gatsby-v2","tags":["v2"]}}},{"node":{"id":"53048efa-8e60-5988-8f54-73bf441a1ab2","frontmatter":{"title":"Should I rebuild my site for Gatsby v2?","path":"/should-i-rebuild-my-site-for-gatsby-v2","tags":["v2"]}}},{"node":{"id":"36c6d2e1-eff2-5062-aee4-518ccb6f4ea8","frontmatter":{"title":"StaticQuery in Gatsby v2","path":"/staticquery-in-gatsby-v2","tags":["v2"]}}},{"node":{"id":"3a89bcb1-591a-5b78-bb39-6a8488d0ce69","frontmatter":{"title":"What's new in Gatsby v2","path":"/whats-new-in-gatsby-v2","tags":["v2","beta"]}}},{"node":{"id":"979a29c5-06ed-5582-b0be-4c37f26b65d4","frontmatter":{"title":"Enable absolute imports for Gatsby v2","path":"/enable-absolute-imports-for-gatsby-v2","tags":["v2"]}}},{"node":{"id":"5eb98a7e-3fd2-5edf-a9f8-44f5e25da39d","frontmatter":{"title":"GatsbyJS source plugin for eventbrite.com","path":"/gatsby-source-eventbrite","tags":["v2","source","eventbrite"]}}},{"node":{"id":"374bf18f-0f86-54c8-bdb1-f051527d8210","frontmatter":{"title":"WordPress starter for GatsbyJS","path":"/gatsby-starter-wordpress","tags":["v2","starter","wordpress"]}}},{"node":{"id":"737d2352-faae-5e91-b298-07399aaf3b1c","frontmatter":{"title":"Starter project for GatsbyJS","path":"/gatsby-central-starter","tags":["v2","starter"]}}}]},"allCommentsJson":null,"allRatingsJson":null},"pageContext":{"tags":["v2"]}}