How to Upgrade SharePoint Framework solutions




Suggested Articles


What is SharePoint Framework (SPFx)

Future prospects of SharePoint Framework (SPFx)

Required tools and libraries for SharePoint Framework (SPFx) development

Setup Office 365 tenant for SharePoint Framework development

Setup SharePoint Framework client side web part development environment

Build SharePoint client side web part using SharePoint Framework (SPFx) – I

Build SharePoint client side web part using SharePoint Framework (SPFx) – II

Build SharePoint client side web part using SharePoint Framework (SPFx) – III

How to Debug SharePoint Framework Solutions in Visual Studio Code

What is the Developers Point of View on SharePoint Framework

What is Required Toolchain for SharePoint Framework

How to Integrate gulp tasks with SharePoint Framework Toolchain

How to Provision SharePoint assets with solution packages


It is a continuation of previous article, if you’ve missed it. I recommend you to first walkthrough the links provided above suggestion for SharePoint Framework.

Let’s begin

In this article, I’ve used same project which I had created in previous article “How to Provision SharePoint assets with solution packages“.



Here, I’ll demonstrate, how to upgrade existing SharePoint Framework (SPFx) app in SharePoint Online.

Now, open existing project in Visual Studio Code and add a new element file named as “elements-v2.xml” with content showed below:




Add another XML file “upgrade-actions-v2.xml” for upgrade action. It should’ve location based on the folder name as a GUID which is placed under SharePoint -> Solution -> debug.




Now make below highlighted changes in “package-solution.json”. You must change below mentioned attributes:



  1. version – It should be increased.
  2. elementManifests – It will also include “elements-v2.xml” file.
  3. upgradeActions – It will hold file name of upgrade actions i.e. “upgrade-actions-v2.xml”




Now run below command:

gulp bundle –ship




Thereafter, create a package for our solution using below command:

gulp package-solution –ship




Now, again deploy (refer “How to Provision SharePoint assets with solution packages”) package .sppkg file. After deployment, you’ll see upgraded version of file in app catalog as below:





If you click on app’s tile, you shall see message to to get upgraded version of app.




Click on Get IT button and see the effect. You’ll see additional new list under site contents.




Thank you for reading…

I hope you enjoyed learning this tutorial and It will help you to move forward in SharePoint Framework (SPFx) world.



Please share your suggestions in the comment box below about this tutorial. This will help me to provide useful content moving forward .

Also don’t forget to share, subscribe and follow Three Queries on social media.

Thank You for your Time!





THREE QUERIES offers easy access to information about SharePoint and associated technologies, project management, agile and scrum methodologies that helps developers, administrators, architects, technical managers, business analysts and end users. It has grown from there. We provide an important knowledge base for those involved in managing, architecture and developing software projects of all kinds. With weekly/daily exclusive updates, we keep you in touch with the latest business, management, technology thinking.

WE ARE CONNECTED ~ Follow us on social media to get regular updates and opinion on what's happening in the world of SharePoint, front-end, back end web technologies and project management. If you like this article, please share it and follow us at Facebook, Twitter, Instagram and LinkedIn

About Satyendra Mishra

Microsoft certified, motivated, energetic and accomplished SharePoint Consultant and Architect with 13+ years of work experience in Management, Architecture, Analytics, Development and Maintenance. He has been fortunate to be a part of over 20+ Web/Mobile/Software SharePoint and .Net projects delivery with various companies across different industry sectors. This has provided him a valuable insight and experience especially in successful implementation of technology solutions. Having very strong System Architecture, Technological, Management & Analytical Skills, Knowledge of Office 365, SharePoint, .Net, JavaScript, React, Angular, Azure, SQL. In 2016, he decided to start sharing the knowledge back to society in the form for content writing and blogging.
View all posts by Satyendra Mishra →

Leave a Reply

Your email address will not be published. Required fields are marked *