Troubleshooting
Messages the app can show, and common puzzles. Messages from the directory connection are listed with the connection guides in the signed-in help.
Signing in
| Message or symptom | What it means | What to do |
|---|---|---|
| That email and password don't match | Wrong email or password. The message is the same for both on purpose. | Try again, or ask the owner for a reset link. |
| Too many failed attempts. Try again in 15 minutes. | Five wrong passwords for this account, or twenty from your address. | Wait 15 minutes. |
| This link has expired or was already used. Ask for a new one. | Invite and reset links work once and last 7 days. | Ask the owner for a new link. |
| Use at least 10 characters | The password is too short. | Choose a longer one. |
| That code isn't right. Codes change every 30 seconds; check the time on your phone. | A wrong or stale authenticator code, or the phone's clock is off. | Wait for the next code; set the phone's time to automatic. A recovery code also works. |
| That sign-in has expired. Start again from your password. | More than 5 minutes passed between the password and the code. | Sign in again. |
| That code isn't right. Use the newest code we emailed you; each one lasts 10 minutes. | An older or expired emailed code, or a typo. | Use the most recent email; ask for a new code if it is more than 10 minutes old. A recovery code also works. |
| A code was emailed a moment ago. | A second code was asked for within a minute. | Check the inbox and spam folder; the first code is still good. Try again after a minute. |
| The code couldn't be emailed right now. | The email service refused or was unreachable. | Sign in with a recovery code; try the email again a little later. |
| Two-factor sign-in is already on. | Set-up was started while it was already in force. | Turn it off first, then set up again. |
| The two passwords don't match. | The two boxes differ. | Retype them. |
The editor
| Message or symptom | What it means | What to do |
|---|---|---|
| Not saved: retrying (red light) | The server refused or could not be reached. The app retries every few seconds. | Check your connection. Your edits are kept in the page meanwhile. |
| The server could not be reached. | The app loaded but MailSlick did not answer, usually a blip in your connection or VPN. | Reload. If it persists for more than a few minutes, contact support. |
| An image could not be prepared: … | An uploaded picture could not be read, or the upload was refused. | Use a PNG, JPEG or GIF under 5 MB. |
| Only PNG, JPEG and GIF images can be used in email | Other formats (SVG, WebP, HEIC) are not supported by mail apps. | Convert the image first. |
| Image is over 5 MB | The file is too large. | Resize or compress it; a signature never shows an image wider than 600 px. |
| Could not reach the API | Same as above. | As above. |
| A control I changed does not show in the preview | Some controls only apply in some layouts: the Compact reply layout drops images and most blocks, and a button or banner needs a link or image before it shows. | Check the layout, and that the block is complete. |
| The phone preview looks small | It shows the email shrunk to fit a phone, as iPhone Mail and Gmail do. | Reduce the logo width, shorten the disclaimer, or use the Stacked layout. |
| The character count is red | Gmail's limit is 10,000 characters. | Shorten the disclaimer or remove a block. |
In the mail app
| Symptom | What it means | What to do |
|---|---|---|
| Blank lines I added in Outlook vanish | Outlook removes blank lines inside a signature when saving. | Use the spacing sliders on the Blocks tab instead. |
| Rounded buttons show square | Classic Outlook ignores rounded corners. | Choose Rounded or Pill for the button; those are sent as pictures. |
| Images show as broken boxes or are missing for recipients | Their mail app blocks images, or the MailSlick server is not reachable from the internet. | Blocked images are normal and recipients can show them; the server address is the server owner's to check. |
| Images arrive as attachments | The signature was pasted with images embedded, or Outlook converted them. | Paste the signature copied from MailSlick, which uses hosted images, rather than one edited in Outlook. |
| The website wraps onto two lines in Outlook's signature box | Outlook's editing box is narrow. | Sent emails show it on one line; check with a test email. |
| Gmail says the signature is too long | Over 10,000 characters. | Shorten it in MailSlick and copy again. |
Outlook add-in
| Symptom | What it means | What to do |
|---|---|---|
| Nobody's signature goes in since the manifest was uploaded again | Microsoft blocks the add-in for everyone until an administrator accepts the changed manifest. | Accept it in Settings → Integrated apps in the Microsoft 365 admin center. See Updating the add-in. |
| A tester is on the add-in's Users list but MailSlick doesn't appear in their Outlook | Microsoft hasn't copied it into their mailbox yet (up to 72 hours). Restarting Outlook doesn't help until it has. | Check their mailbox from PowerShell (Checking whether it has reached someone's mailbox); if it still isn't there after 72 hours, update the add-in with a fresh manifest. |
| The add-in is installed but never inserts anything | It was installed by the person from the Outlook store, not deployed by an administrator. | Deploy it from the admin center (Step 2). |
| Someone added to a group still doesn't get it | They are in a group nested inside the group the add-in is assigned to. | Add them to the assigned group directly. |
| No signature on a new calendar invitation | Outlook on the web and new Outlook don't let add-ins sign appointments. | Expected there; classic Outlook and Outlook for Mac sign them. |
| No signature on a reopened draft, an RSVP with a note, or a meeting forwarded from the calendar | Outlook doesn't start add-ins in those cases. | Click MailSlick → My signature and Insert again. |
| Sometimes no signature, at random | The message was left before the add-in finished, or there was no internet connection. | Wait a second or two after opening a message; use Insert again. |
| The wrong person's signature after changing From | The signature was put in for the original sender. | Delete it and insert again, or use the mail-flow rules for shared mailboxes. |
| Two signatures | Outlook's own signature, or another signature add-in, is also set. | Set Outlook's signature to (no signature); remove the other add-in. |
| Nothing at all in classic Outlook, on one computer | Its Office is older than Version 2403. | Update Office (File → Office Account → Update Options). |
Organization area
| Symptom | What it means | What to do |
|---|---|---|
| No Organization switch | Your account is not an admin. | Ask the owner to tick Admin beside your name. |
| No people yet | No directory is connected, or it has not synced. | Connect Microsoft 365 and click Sync now. |
| A group matches nobody | The rule's value does not match anyone's directory data; security-group rules also need the GroupMember.Read.All permission. | Check the value against the People list, or the permission in the Microsoft 365 dialog's status message. |
| A field in the group editor cannot be edited | It comes from Microsoft 365, set in the organization template. | Change it per person on their page, or switch it off in the template. |
| Someone's own changes are gone | They left the directory (or were disabled), so their layer was removed; the activity log says so. | Nothing; if they return, set the changes again. |