Updating the Page Designer App When Major/Minor Versions Update

With apps in Modern SharePoint, version numbers are represented as major.minor[.build[.revision]]. Generally, when we update Page Designer for Modern it will increment the revision. When this occurs, the update will automatically be applied without any required intervention.

As an example, a change to the revision in versioning increments the fourth decimal in the version number, so v. X.X.X.1 would turn into v. X.X.X.2.

When new components are added or large-scale updates occur, the major version will update.

A major version update requires:

• downloading a new version of the Page Designer sppkg
• adding the new version to the app catalog which will replace the old version
• redeploying, and updating the app

Though rarely occurring, this process is how Modern SharePoint requires apps to update when incrementing the major or minor version.

A change to the major version increments the first decimal in the version number. For example,  v. 1.X.X.X would turn into v. 2.X.X.X.

A minor version increments the second decimal, so v. X.0.X.X. would turn into v. X.1.X.X.

For more documentation on versioning standards, please visit https://docs.microsoft.com/en-us/dotnet/api/system.version?view=netframework-4.8

Updating the App After Major/Minor Version Increments

If a new major or minor version of Page Designer for Modern is released, this support document will have the updated URL for downloading the newest version of the Page Designer for Modern sppkg in the Getting Started section. It will also be given in a product update announcement.

There is a bit of a process for updating to a major version, which will be detailed below:

1. Download the newest version of the Page Designer for Modern sppkg.
   1. This can be found in product update announcements, or at the top of this support article.
2. Upload the newest version to your site collection’s app catalog.
   1. When asked to replace the currently existing app, click Replace It.
3. After replacing the app, SharePoint will have a modal appear to deploy the app.
   1. If you are performing a tenant wide deployment, toggle the Deploying to Entire Site check box.
   2. If you are performing a tenant wide deployment, then you are done, and you can skip the remaining steps! Otherwise, if you deployed by site collection, there are a few more steps.
4. If deployment was performed by the site collection only and not the tenant, once the newest version is deployed, the app will need to be updated > Navigate back to your site collection’s home.
5. Once at the site collection home > click the cog in the top right > click on Site Contents.
6. SharePoint doesn’t allow updating apps in the Modern view. Switch back to the classic view.
7. Once in the classic experience > hover over the LiveTiles Page Designer app > click on the ellipsis.
8. Once the pop up appears > click on About.
9. If the app needs to be updated, there will be a notification advising you to update
10. If the About says “Good news – you already have this on your site.”, then you are currently up to date