I cannot find a user in the drop-down list
General rule is that our app automatically takes all users from the parent site (where the app is installed) using SharePoint API.
There could be four reasons that you cannot see the user:
1.User should log into the SharePoint Site at least once
User Information entries are added when a user logs into a site. So users may have a fully configured user profile and may have access to a site, but until they login they won't have a complete User Information entry.
2.User doesn't have "Work Email" field set up correctly.
Users without "Work Email" field cannot receive any email notification from SharePoint so we exclude them from the list.
To resolve this issue please go to SharePoint Admin Center->Click on user profiles in the left navigation ->Click Manage User Profiles-> Search for the user who's settins you would like to modify -> Edit My Profile
Notice: This change is not in real-time. Please allow some time (few hours) for the changes sync to your SharePoint site.
3.Property "Work Email" is not "Replicable" in policy settings
Replicable checkbox must be checked. To resolve this issue please go to the SharePoint Admin Center->User Profiles->Manage Policies, then click edit on "Work Email" property and make sure that "Replicable" checkbox is checked
4.User doesn't have permissions to the parent site (where the app is installed)
To resolve this issue please go to the Parent Site settings->Site permissions->"Site name" Members and add selected users.
I don't receive any email notifications
There could be couple of reasons:
1. The user who needs to be notified should log into the SharePoint Site where app is installed at least once.
SharePoint policy is that User Information entries are added when a user logs into a site, so user needs to login at least once.
2.User doesn't have "Work Email" field set up correctly.
Please expand question "I cannot find a user in drop-down list" from this FAQ and check how to setup "Work Email" field.
3.SharePoint Site URL where app is installed was changed
It's known SharePoint issue that built-in SharePoint Workflow not running after changing site URL (here is more info.)
If you use SharePoint on-premise you need to reconfigure Workflow Manager.If you use SharePoint Online (O365) please create ticket for Microsoft.
Another workaround is app reinstallation, however this operation "clears" all app data and configuration (new instance is empty).
4.If you created shortcut to the app - make sure that you have done it correctly.
Please expand question "How to create application shortcut on SharePoint site? " from our FAQ to get more info
5.Make sure that SharePoint 2013 workflows are not blocked
Go to SharePoint Admin Center->Settings and make sure that checkbox below is unchecked.
6.Review email messages moved to the Junk Email folder in email client (i.e.Outlook).
Users can have strict spam protection rules on workstation that moves email from our apps to the "Junk" folder.
7.Prevent false positive email marked as spam at mail-server level (i.e. MS Exchange)
A false positive is a legitimate email message that was incorrectly identified as spam. You can define no-reply@SharePointonline.com as "safe sender", here is more info.
8.Check Workflow Health page to see workflow status
To access Workflow Health page: enter the app, copy app URL from the browser's address bar, remove all characters string after app name and put this string /_layouts/15/WorkflowServiceHealth.aspx
Workflow Health URL pattern:
Step 1) If workflow is in "Suspended" state from some reason, you can terminate it and create another request in the app for testing purposes
Step 2) If workflow is in "Suspended", "Canceled" or "Terminated" state, click on info icon to get detailed info
Step 3) Click on workflow name, on page "Change a Workflow" check if one of following items is selected:
a) "Creating a new item will start this workflow" or
b) "Changing an item will start this workflow"
9.Try to re-install the app on the different SharePoint site.
Sometimes the site where the app is installed could have custom settings that doesn't allow to send email notifications. This option should be used for newly installed apps - app reinstallation "clears" all app data.
I cannot install SharePoint app on my SharePoint site
Please read the following sections, depending on the error message that you receive.
1."Sorry, this app is not supported on your server" error when attempting to install the app
If you use SharePoint Online: please submit a ticket to the Microsoft support team (Microsoft 365 Admin Center->Support->New service request) and describe that you want to enable SharePoint 2013 Workflows for a given SharePoint Site Collection (you need to send URL of Site Collection in ticket's description)
If you use SharePoint on-premise , there could be couple of reasons :
1) SharePoint on-premise must be configured for using apps first. For more info please read question "Can I run your app on SharePoint 2013/2016 on-premise?" from our FAQ.
2) Prerequisite is "Workflow Manager 1.0" installed and configured. Our apps doesn't work with SharePoint Foundation (free version) due to lack of Workflow Manager 1.0 support.
3) Update your Workflow Manager 1.0 (i.e.with CU3)
4) Check SharePoint 2013 workflow troubleshooting
5) Go to the SharePoint Central Administration=>Services and make sure that a service User Profile Synchronization Service is started.
2."Sorry, something went wrong. An unexpected error has occurred." or
"Everything is fine, but we had a small problem getting your license. Please go back to the SharePoint Store to get this app again and you won't be charged for it"
SharePoint policy is that you cannot install SharePoint app by using the System Account, so to avoid this issue you need to log in to SharePoint with a different account.
You can also try to use different browser, some users noticed that this issue might appear on Firefox browser (try to use Internet Explorer instead)
3."Sorry, there was something wrong with the download. Try adding it again."
It could be language type mismatch between your SharePoint site language and app language. To solve this problem, change the language during app installation:
You can also check ULS logs to get more detailed error message. For example the default path log location for Sharepoint 2013:
C:\Program Files\Common Files\Microsoft Shared\Web Server Extensions\15\Logs
Can I run apps on SharePoint 2013/2016/2019 on-premise?
Yes, but SharePoint on-premise needs to be configured for using apps and Workflow Manager 1.0 must be installed and configured. In SharePoint 2019 Workfow Manager was rebranded as SharePoint Workflow Manager (SPWFM).
Below articles describe how to configure SharePoint on-premise to support apps:
Configure an environment for apps for SharePoint Server
Install and configure workflow for SharePoint Server
If you have problems with app installation (i.e. "Sorry, this app is not supported on your server") please read question "I cannot install SharePoint app on my SharePoint site" from our FAQ.
How to delete the old user from the user drop-down list?
User list is pulled from SharePoint User Information List (built-in SharePoint feature, here is more info)
You can enter Information List and remove user manually.
To enter Information List you need to add following character string to the URL of the parent site:
For example if you installed the app on the site:
final URL will looks like below:
I'm getting an "Authorization Error"
Probably you are using wrong link to access the app (i.e. shortcut made from random app URL).
Please use one of below methods to create an app shortcut.
Method 1) Enter the app (first page) and copy full URL from the browser's address bar (with all parameters like SPHostUrl etc.), below is example:
Method 2) Enter the app (first page), copy URL from the browser's address bar and remove all characters after app name, below is example:
Required parameters will be automatically added by SharePoint.
To pin app to the SharePoint menu, please use steps described in question "How to pin the app to the SharePoint menu or Office 365 app launcher?" from the Product FAQ (at the bottom of product site)
How to assign a regular user role?
There is no need to assign regular User role, because this role is given by default - every user with access to the SharePoint parent site (where the app is installed) also has access to this app as regular user.
If you want to limit access to a specific set of users, you can install app on new SharePoint sub-site with limited access.
How to uninstall the SharePoint app?
1. Go to the SharePoint Site Contents, if you use modern view click "Return to the classic SharePoint" (bottom-left corner)
2. Click three dots near app icon and select "Remove" from menu
How to update the SharePoint app?
1. Open SharePoint Site where the app is installed and click on link "Site Contents" (might be located in the left or top SharePoint menu)
2. Click three dots near the app icon and select the option "DETAILS" from the menu
3. Click "GET IT" button
4. Click "Trust It"
The update process usually takes 2-4 minutes, is always free of charge, and doesn't affect app data.
If you see the "RENEW" button instead of the "GET IT" button you need to perform license recovery and afterward update app again
1. Click button "RENEW"
3. Click button "Continue"
4. Click button "Purchase"
Update or license renewal is always free of charge (you won't be charged when you click on Purchase button)