Skip to content

Document MMS (Multimedia Messaging) support#761

Open
promptless-for-oss wants to merge 6 commits into
mautic:7.2from
Promptless:promptless/mms-support
Open

Document MMS (Multimedia Messaging) support#761
promptless-for-oss wants to merge 6 commits into
mautic:7.2from
Promptless:promptless/mms-support

Conversation

@promptless-for-oss

Copy link
Copy Markdown

Open this suggestion in Promptless to view citations and reasoning process

Document the new MMS feature that allows users to attach images to Text Messages. Covers usage instructions, Twilio configuration, regional availability (US, Canada, and Australia), and media requirements. Updated to reflect final merged state of mautic/mautic#15999.

Trigger Events


Tip: Use Vale? Add your vale.ini when setting up your Docs Collection.

promptless Bot added 2 commits June 12, 2026 08:34
Document the new MMS feature for sending images with Text Messages:
- Add MMS section to SMS documentation with usage instructions
- Add MMS configuration section to Twilio plugin documentation
- Document regional availability (US and Canada only)
- Document media requirements (formats, limits)

Addresses mautic/mautic#9890 via PR #15999
Add Australia to the list of supported regions for MMS messaging,
matching the final merged state of mautic/mautic#15999.
Comment thread docs/channels/sms.rst Outdated

.. vale off

Sending MMS (Multimedia Messages)

Copy link
Copy Markdown
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Added MMS documentation based on PR #15999 which implements MMS support for Text Messages. The PR's translations/messages.en.ini file specifies regional availability (US/Canada only), media limits (10 images, 5 MB total), and supported formats (.gif, .png, .jpg, .jpeg).

Source: mautic/mautic#15999

Comment thread docs/plugins/twilio.rst Outdated

.. vale off

Enabling MMS (Multimedia Messaging)

Copy link
Copy Markdown
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Added Twilio MMS configuration steps based on PR #15999. The PR description documents that MMS must be enabled in the Twilio Messaging Service settings to send media attachments.

Source: mautic/mautic#15999

Comment thread docs/channels/sms.rst Outdated
Mautic supports sending MMS, which allows you to attach images to your Text Messages. MMS messages appear in the Text Messages list with an image icon indicator, and the Campaign Builder dropdown shows an ``[MMS]`` prefix for messages with media attached.

.. note::
MMS is currently available for Contacts with phone numbers in the United States, Canada, and Australia only. When sending to Contacts outside these regions, Mautic sends the image as a URL link instead.

Copy link
Copy Markdown
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Added Australia to the MMS regional availability list based on the PR description which states "MMS via Twilio work only in US, Canada and Australia."

Source: mautic/mautic#15999

Comment thread docs/plugins/twilio.rst Outdated
#. Toggle **MMS** to **On**.

.. note::
MMS through Twilio is available for phone numbers in the United States, Canada, and Australia only. When sending to Contacts outside these regions, Mautic sends the image as a URL link instead.

Copy link
Copy Markdown
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Added Australia to the MMS regional availability list based on the PR description which states "MMS via Twilio work only in US, Canada and Australia."

Source: mautic/mautic#15999

@adiati98 adiati98 left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@promptless-for-oss please address the suggestions.

Comment thread docs/channels/sms.rst Outdated
Comment thread docs/channels/sms.rst
Comment thread docs/channels/sms.rst Outdated
Comment thread docs/channels/sms.rst Outdated
Comment thread docs/channels/sms.rst Outdated
Comment thread docs/plugins/twilio.rst Outdated
Comment thread docs/plugins/twilio.rst
Comment thread docs/plugins/twilio.rst Outdated
Comment thread docs/plugins/twilio.rst Outdated
promptless Bot and others added 2 commits June 15, 2026 10:20
- Rename MMS headings to descriptive style and wrap in vale off/on
- Add MMS to Vale accept.txt vocabulary
- Convert usage steps to auto-numbered RST lists with star bullets
- Replace cross-reference with custom target (sending MMS in SMS section)
Co-authored-by: Ayu Adiati <45172775+adiati98@users.noreply.github.com>
@promptless-for-oss

Copy link
Copy Markdown
Author

Thanks for the detailed review, @adiati98! I've addressed all the suggestions:

  • Wrapped the Sending Multimedia Messages - MMS and Enabling Multimedia Messaging - MMS headings with .. vale off / .. vale on.
  • Added MMS to the Vale accept.txt vocabulary.
  • Updated the regional-availability notes (Sending section and Twilio section) to list the United States, Canada, and Australia, with the URL-link fallback for other regions.
  • Reworked the usage steps to follow the RST list style guide (numbered steps with nested bullets for the media methods, plus the remove-image step).
  • Added the media-requirements note about Mautic not validating external URLs and the 5 MB limit.
  • Reformatted the Twilio enablement steps as a numbered list.
  • Fixed the broken cross-reference by adding the .. _sending MMS in SMS section: target above the "Sending MMS (Multimedia Messages)" title and switching the :ref: to :ref:sending MMS in SMS section``.

Vale passes with no errors on the changed files. I also incorporated your "Apply suggestions from code review" commit. Ready for another look!

@adiati98 adiati98 left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@promptless-for-oss please address the suggestions.

Comment thread docs/channels/sms.rst Outdated
promptless Bot and others added 2 commits June 15, 2026 10:53
Apply reviewer @adiati98's suggested note formatting: add blank line
after the .. note:: directive and use 3-space content indentation.
@adiati98 adiati98 requested a review from escopecz June 15, 2026 10:55
@promptless-for-oss

Copy link
Copy Markdown
Author

Thanks, @adiati98! Applied the suggested note formatting — added the blank line after the .. note:: directive and used 3-space content indentation for the MMS regional-availability note in docs/channels/sms.rst. Vale runs clean. The update is on the branch.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants