Email Settings - Mail Server and Notifications
Control Center can email a summary each time a source’s analysis finishes, and warn you when download or report storage runs low. You set up the mail server and the recipients under Settings > Email. Only Control Center administrators can open Settings.
Set up the mail server
- Go to Settings > Email.
- Turn on SMTP settings.
- Fill in the mail server details:
- SMTP server URL: your mail server, for example
smtp.office365.com. - Port: 587 by default.
- Sender email: the address emails come from, for example
shinydocs@contoso.com. - Sender name (optional): the name recipients see.
- SMTP server URL: your mail server, for example
- Choose the Authentication method:
- Username & password: enter the Password of the sender’s mailbox. The Username is always the Sender email.
- Microsoft 365 (OAuth): enter the Tenant ID, Application ID and Client secret of an app registration in Microsoft Entra ID that can send mail as the sender address over SMTP. Microsoft describes the setup in Authenticate an IMAP, POP or SMTP connection using OAuth.
- To check the settings before saving, open Send a test email, enter an address in Send test to, and select Test. The test uses the values in the form, saved or not, and sends a sample analysis summary for a source called Test Source. If it fails, the reason appears at the top of the form.
- Select Save changes.
Control Center uses STARTTLS when the mail server offers it. There is no option for SSL on connect, so use a port that supports STARTTLS, such as 587. Passwords and client secrets are stored encrypted and shown as asterisks afterwards.
Choose who gets notifications- Turn on Email notifications. You can only turn it on while SMTP settings is on.
- Select Add recipient and enter the Recipient email, and optionally the Recipient name (optional).
- Choose the Language of that person’s emails: English (
en) or French (fr). - Add as many recipients as you need, then select Save changes.
Every recipient gets every notification. There is no unsubscribe link: to stop someone’s emails, select Remove next to them and save.
What Control Center sends| When | Sent to | |
|---|---|---|
| Analysis summary, for example Shinydocs content intelligence for ‘Finance share’ completed successfully (or was cancelled, completed with errors) | Each time all the analysis on a source finishes. It shows files scanned, storage, files with issues, PII and sensitive data, duplicate, redundant, obsolete and trivial files, recommended actions, and a View dashboard link. | The recipients, when Email notifications is on |
| Storage warnings: download or report storage running low, or a download or report that couldn’t start for lack of disk space | Once each time free space drops below the Warn below (% free) threshold you set in Action Settings - Downloads and Reports. | The recipients, when Email notifications is on |
| Download finished: … is ready to download or … did not complete | When a download from the Catalog finishes, if an address was entered in Email when completed. Downloads need the Document Mobility add-on. | The address entered for that download, whether or not Email notifications is on |
The View dashboard link in the summary uses the address set with Enable custom URL under Settings > Server. Without one, it points to
https://localhost:9701, which only works on the Shinydocs Pro server itself. Set a custom URL so the link works for your recipients.
Saving these settings is recorded in Settings > Audit.
The View dashboard link in the summary uses the address set with Enable custom URL under Settings > Server. Without one, it points to