Installation using the Classic App Management Experience
To install Lightning Tools Actions into your SharePoint Online Tenant, you must be at least a SharePoint Administrator and a Site Collection Admin of the tenant App Catalog site. Please follow these steps:
- Download the Lightning Tools Lightning Tools Actions Files.
- If you are planning on installing the trial version, please download it by completing the following online form: Download Here (Note: you will receive an email from Lightning Tools with the direct download link in the email).
- If you are an existing customer, you can download the latest release from here: Download Here
- Extract the downloaded zip file and locate the file called lightning-list-actions.sppkg.
- Meanwhile, open a browser and navigate to your App Catalog. [The following steps are for the “classic” App Catalog; if you are using the modern App Management experience, please see the section below.] The url will typically be: https://[TenantName].sharepoint.com/sites/appcatalog/SitePages/Home.aspx
- Within the AppCatalog site, please open the Apps for SharePoint library from the left-hand navigation pane.
- Drag and drop the lightning-list-actions.sppkg file into the Apps for SharePoint library.
- You will be prompted as to whether you trust it. If you wish to use the product, please check the check box “Make this solution available to all sites in the organization” and click Deploy.
- Congratulations, you have now installed Lightning Tools Actions!
Installation using the Modern App Management Experience
- Open a browser and navigate to your App Catalog from your SharePoint Admin Center. This can be found under More Features in the left navigation, then Open the Apps tile. If this is the first time an app has been added to your environment, the App Catalog site collection will be automatically provisioned at this point.
- In the modern App Catalog interface, click Upload and then browse to the extracted folder. Select the lightning-list-actions.sppkg file.
- The Enable App panel will open on the right side. It will give you some information about the app, and allow you to choose how you wish to deploy the app (its availability). We recommend the default setting: Enable this app and add it to all sites. This will make Lightning Tools Actions available to add to any site in your tenant. The other option (Only enable this app) will enable the app in the App Catalog, but if someone wishes to use it on a site, they will need to use SharePoint’s Add an App feature on that site to add Lightning Tools Actions there. In either case, click the Enable App button.
- Next, a panel that says “Approve access so this app works as designed” will appear. This is because Lightning Tools Actions takes advantage of several Microsoft Graph entities, and approval must be given by a Global or Application Admin to allow Lightning Tools Actions to make requests to the Microsoft Graph. If you are a Global Admin, click Go to API access page. Otherwise, a Global Admin can come back and do the approvals later via the API access link on the left menu of the App Catalog.
- This will take you to the API Access page, which normally takes a moment to load. You should eventually see a few pending permission requests by Lightning Tools Actions. You can view a current list of Lightning Tools Actions API permission requests in this Knowledge Base article. The article also describes the purpose of each request; you may find that some are not necessary to approve if you don’t plan to use the relevant feature.
- Approve the appropriate pending requests one by one. It’s not possible to approve them in bulk.
- Congratulations, you have now installed Lightning Tools Actions!