When sending messages through Messages XR Enterprise, you may encounter error messages. This guide explains the most common errors and how to resolve them.
Before you start
This article is part of our message delivery troubleshooting series. Looking for something else? Check out the full set:
- Message delivery troubleshooting: Common Errors (this article)
- SMS vs. email delivery: What you need to know
- Before you send: Pre-delivery checklist
Have questions about your district's specific message setup or delivery options? Every organization is unique! Look in these two places first for your site's custom configurations and directions:
- Your Messages XR Enterprise Organization Config > Delivery options
- Still not sure? Contact site administrator or Finalsite support
Quick reference table
| Error message | Why it happens | Quick fix |
|---|---|---|
| "Failed to send. Type error: A match is not a function" | Special characters, emoji, or corrupted browser cache | Clear browser cache, try different browser, use standard characters only |
| "Fix languages" error | Message too long to translate into selected languages | Reduce message length, disable auto-translate, or use email |
| "Message not delivering - No supported language" | SMS provider doesn't support selected language or characters | Use English for SMS, use email for translations |
| "500 server error" | Large attachments, multiple links, or extremely large recipient lists | Remove attachments/links, verify recipient list, break into smaller groups |
| Recipient list spinning/not loading | System timing out loading large recipient groups | Use advanced filters instead of file uploads, reduce file size |
| "Character limit exceeded" | Message too long for delivery method | Shorten message or use email |
| "Permission denied" | User role doesn't have permission to send to this group | Contact administrator to request permission |
💡 Quick reference
- "Failed to send. Type error: A match is not a function" – clear your browser cache, try a different browser, and check for special characters or emoji in your message
- "Fix languages" error – your message is too long to translate into the selected languages; reduce your message length or remove auto-translate
- "Message not delivering - No supported language" – the SMS provider doesn't support the selected language; use English for SMS and email for translations
- "500 server error" – try removing attachments or links, verify your recipient list loads properly, or break large groups into smaller segments
- Recipient list spinning/not loading – use advanced filters instead of file uploads for large groups, or test your recipient selection before composing your message
Detailed fixes
"Failed to send. Type error: A match is not a function"
- Clear your browser cache and cookies
- Close and reopen your browser
- Use only standard characters (letters, numbers, punctuation)
- Avoid emoji, accents, and special symbols
- Try a different browser if the error persists
"Fix languages" error when using auto-translate
- Disable auto-translate and manually select only the languages you need
- Reduce your message to under 60 characters for SMS
- Or use email instead (email translations don't have character limits)
"Message not delivering - No supported language"
- For SMS: use English only, or send email for non-English languages
- Check that your message uses standard ASCII characters only
- Avoid accents, emoji, and special symbols
"500 server error" when sending
- Try removing attachments and links
- Send a text-only test message
- Verify your recipient list loads properly before sending
- Break large groups into smaller segments (under 5,000 recipients each)
- Wait a few minutes and try again
Recipient list spinning or not loading
- Use advanced filter instead of file upload
- Reduce the group size (split into segments)
- Refresh and try again
- Contact your administrator if it continues
Prevention: Test before you send
- Compose your message using only standard characters
- Select 2-3 test recipients (yourself, a coworker, a family member)
- Send the test message
- Verify it arrived and looks correct
- Now send to your full recipient list