SPFx Compatibility Matrix

NOTE: This matrix can also be found in the SharePoint Framework Developer documentation where I hope that the community will continue to help me maintain it.

Introduction

A while ago, I was looking for an official list of which version of SPFx is compatible with each SharePoint version, but I couldn’t find what I wanted.

I kinda forgot about it until today, when someone reached out to me and asked me if I had a SPFX/SharePoint compatibility matrix handy.

As I turns out, I had created such a matrix when I wrote my SPFX timeline.

So, as I am the world’s laziest developer, I figured it would be very little effort to put such a matrix together by leveraging work I had already done.

The list in this post is not an official list; it is based on my interpretation of the SPFx release notes. If you find an error in it, please let me know and I’ll fix it.

SPFx Version Compatibility

SPFx Development Environment Compatibility

PRO TIP: If you need to download a previous of Node.js, use the previous releases page from their download section. You can also use links in the table below to download the versions of Node.js directly.

Conclusion

If I made any mistakes in the list above, please do not hesitate to write in the comments. I’ll gladly update my matrix.

I still think that there should be an official compatibility list something in the SharePoint Documentation.

Maybe I should just submit a PR to the SP Dev Docs repo and hope the community will help me keep my compatibility matrix accurate?

Thanks

• Thanks to David Warner II for the inspiration for this post and for helping fix my mistakes
• While doing my research for this post, I found Andrew Connell has also written a handy article.

Updates

• September 14, 2023: SPFx 1.18 is here! (I know, I’m a little late)
• June 27, 2022: SPFx 1.15 and updated my blog.
• Feb 19th, 2022: SPFx 1.14 is here!
• June 25, 2021: Totally forgot about SPFx 1.12.1
• March 15, 2021: Added SPFx 1.12
• October 5, 2020: Added links to download versions of Node.js directly.
• September 11, 2020: Thanks to Don Kirkham for suggesting that we add the link to Node.js previous versions page.
• March 20, 2020: Moved this article to the SharePoint Framework Developer documentation where I hope that the community will continue to help me maintain it.
• January 12, 2020: I love it when people take the time to write in comments to help me keep content up-to-date! Thank you Ronald Borman for the many corrections to my matrix. Keep ’em coming!
• January 2, 2020: Thanks to David Warner II for pointing out that Andrew Connell has an awesome article on how to use NVM as a better Node package manager. It is a great solution if you need to run multiple versions of Node.js on the same environment.