From 9b0c077223b237f4afdf1b2464c91c8e5e29f08f Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Guillermo=20Vay=C3=A1?= Date: Mon, 20 Apr 2026 12:59:11 +0200 Subject: [PATCH 1/5] docs: add /mobile-logs slash command Document the new /mobile-logs command introduced in mattermost/mattermost#35658, which toggles the attach_app_logs preference to enable attaching mobile app logs as a file in the Mattermost mobile client (v2.38+) for debugging. Co-Authored-By: Claude Opus 4.7 (1M context) --- .../built-in-slash-commands.rst | 18 ++++++++++++++++++ 1 file changed, 18 insertions(+) diff --git a/source/integrations-guide/built-in-slash-commands.rst b/source/integrations-guide/built-in-slash-commands.rst index 7f87e7fe45a..a97faec7581 100644 --- a/source/integrations-guide/built-in-slash-commands.rst +++ b/source/integrations-guide/built-in-slash-commands.rst @@ -56,6 +56,24 @@ Manage channels - Edit the channel header using ``/header {text}`` or the channel purpose using ``/purpose {text}``. - Rename a channel using ``/rename {text}``. +Manage mobile app log attachments +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +Use ``/mobile-logs`` to enable an attachment option in the Mattermost mobile client that lets users attach their mobile app logs as a file to the message being sent. This helps administrators and support engineers debug mobile-specific issues by providing device-side context that isn't available from server logs alone. The command updates the ``attach_app_logs`` advanced preference and always responds with an ephemeral message visible only to the invoking user. + +.. note:: + + This command requires Mattermost mobile app v2.38 or later. On earlier versions the preference can still be set, but the attachment option won't appear in the mobile client. + +- Enable log attachment for yourself using ``/mobile-logs on``. +- Disable log attachment for yourself using ``/mobile-logs off``. +- Check your current setting using ``/mobile-logs status``. +- System admins can manage the setting for another user by appending a username, such as ``/mobile-logs on @username``, ``/mobile-logs off @username``, or ``/mobile-logs status @username``. + +.. note:: + + Non-admin users can only manage their own preference. Attempts to target another account return a neutral *Unable to change mobile log settings for that user* message to avoid username enumeration. Preference changes made through this command are recorded in the audit log. + More useful slash commands ~~~~~~~~~~~~~~~~~~~~~~~~~~ From 1bb1663643071f2f0cbaa48cd97a7cba706b30a7 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Guillermo=20Vay=C3=A1?= Date: Mon, 20 Apr 2026 13:44:59 +0200 Subject: [PATCH 2/5] docs: refine /mobile-logs admonition and wording - Elevate security/audit note to .. important:: - Use bold instead of italics for the error message - Clarify the attachment applies to any message the user sends Co-Authored-By: Claude Opus 4.7 (1M context) --- source/integrations-guide/built-in-slash-commands.rst | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/source/integrations-guide/built-in-slash-commands.rst b/source/integrations-guide/built-in-slash-commands.rst index a97faec7581..c801dda0b09 100644 --- a/source/integrations-guide/built-in-slash-commands.rst +++ b/source/integrations-guide/built-in-slash-commands.rst @@ -59,7 +59,7 @@ Manage channels Manage mobile app log attachments ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -Use ``/mobile-logs`` to enable an attachment option in the Mattermost mobile client that lets users attach their mobile app logs as a file to the message being sent. This helps administrators and support engineers debug mobile-specific issues by providing device-side context that isn't available from server logs alone. The command updates the ``attach_app_logs`` advanced preference and always responds with an ephemeral message visible only to the invoking user. +Use ``/mobile-logs`` to enable an attachment option in the Mattermost mobile client that lets users attach their mobile app logs as a file to any message they send. This helps administrators and support engineers debug mobile-specific issues by providing device-side context that isn't available from server logs alone. The command updates the ``attach_app_logs`` advanced preference and always responds with an ephemeral message visible only to the invoking user. .. note:: @@ -70,9 +70,9 @@ Use ``/mobile-logs`` to enable an attachment option in the Mattermost mobile cli - Check your current setting using ``/mobile-logs status``. - System admins can manage the setting for another user by appending a username, such as ``/mobile-logs on @username``, ``/mobile-logs off @username``, or ``/mobile-logs status @username``. -.. note:: +.. important:: - Non-admin users can only manage their own preference. Attempts to target another account return a neutral *Unable to change mobile log settings for that user* message to avoid username enumeration. Preference changes made through this command are recorded in the audit log. + Non-admin users can only manage their own preference. Attempts to target another account return a neutral **Unable to change mobile log settings for that user** message to avoid username enumeration. Preference changes made through this command are recorded in the audit log. More useful slash commands ~~~~~~~~~~~~~~~~~~~~~~~~~~ From 10c0dd5903975ebf42364024c621b83bab6a5d0b Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Guillermo=20Vay=C3=A1?= Date: Wed, 6 May 2026 12:30:37 +0200 Subject: [PATCH 3/5] address reviews --- .../mobile/mobile-troubleshooting.rst | 20 ++++++++++++++++++- .../built-in-slash-commands.rst | 20 +------------------ 2 files changed, 20 insertions(+), 20 deletions(-) diff --git a/source/deployment-guide/mobile/mobile-troubleshooting.rst b/source/deployment-guide/mobile/mobile-troubleshooting.rst index 0c510fbaaeb..e55f719af57 100644 --- a/source/deployment-guide/mobile/mobile-troubleshooting.rst +++ b/source/deployment-guide/mobile/mobile-troubleshooting.rst @@ -20,6 +20,24 @@ Login with ADFS/Office365 is not working In line with Microsoft guidance we recommend `configuring intranet forms-based authentication for devices that do not support WIA `_. +How do I attach mobile app logs to a message? +--------------------------------------------- + +Use ``/mobile-logs`` to enable an attachment option in the Mattermost mobile app that lets users attach their mobile app logs as a file to any message they send. This helps administrators and support engineers debug mobile-specific issues by providing device-side context that isn't available from server logs alone. The command updates the ``attach_app_logs`` advanced preference and always responds with an ephemeral message visible only to the invoking user. + +.. note:: + + This command requires Mattermost mobile app v2.38 or later. + +- Enable log attachment for yourself using ``/mobile-logs on``. +- Disable log attachment for yourself using ``/mobile-logs off``. +- Check your current setting using ``/mobile-logs status``. +- System admins can manage the setting for another user by appending a username, such as ``/mobile-logs on @username``, ``/mobile-logs off @username``, or ``/mobile-logs status @username``. + +.. important:: + + Non-admin users can only manage their own preference. Attempts to target another account return a neutral **Unable to change mobile log settings for that user** message to avoid username enumeration. Preference changes made through this command are recorded in the audit log. + I see a “Connecting…” bar that does not go away ----------------------------------------------- @@ -147,4 +165,4 @@ If you did not receive a push notification when testing push notifications, use To conserve disk space, once your push notification issue is resolved, go to **System Console > Environment > Logging > File Log Level**, then select **ERROR** to switch your logging detail level from **DEBUG** to **Errors Only**. -If push notifications are not being delivered on the mobile device, confirm that you're logged in to the **Native** mobile app session through **Profile > Security > View and Log Out of Active Sessions**. Otherwise, the `DeviceId` won't get registered in the `Sessions` table and notifications won't be delivered. \ No newline at end of file +If push notifications are not being delivered on the mobile device, confirm that you're logged in to the **Native** mobile app session through **Profile > Security > View and Log Out of Active Sessions**. Otherwise, the `DeviceId` won't get registered in the `Sessions` table and notifications won't be delivered. diff --git a/source/integrations-guide/built-in-slash-commands.rst b/source/integrations-guide/built-in-slash-commands.rst index c801dda0b09..3616eadb521 100644 --- a/source/integrations-guide/built-in-slash-commands.rst +++ b/source/integrations-guide/built-in-slash-commands.rst @@ -56,24 +56,6 @@ Manage channels - Edit the channel header using ``/header {text}`` or the channel purpose using ``/purpose {text}``. - Rename a channel using ``/rename {text}``. -Manage mobile app log attachments -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -Use ``/mobile-logs`` to enable an attachment option in the Mattermost mobile client that lets users attach their mobile app logs as a file to any message they send. This helps administrators and support engineers debug mobile-specific issues by providing device-side context that isn't available from server logs alone. The command updates the ``attach_app_logs`` advanced preference and always responds with an ephemeral message visible only to the invoking user. - -.. note:: - - This command requires Mattermost mobile app v2.38 or later. On earlier versions the preference can still be set, but the attachment option won't appear in the mobile client. - -- Enable log attachment for yourself using ``/mobile-logs on``. -- Disable log attachment for yourself using ``/mobile-logs off``. -- Check your current setting using ``/mobile-logs status``. -- System admins can manage the setting for another user by appending a username, such as ``/mobile-logs on @username``, ``/mobile-logs off @username``, or ``/mobile-logs status @username``. - -.. important:: - - Non-admin users can only manage their own preference. Attempts to target another account return a neutral **Unable to change mobile log settings for that user** message to avoid username enumeration. Preference changes made through this command are recorded in the audit log. - More useful slash commands ~~~~~~~~~~~~~~~~~~~~~~~~~~ @@ -81,4 +63,4 @@ More useful slash commands - Open the in-product Marketplace using ``/marketplace``. - Display a list of keyboard shortcuts using ``/shortcuts``. - Open the **Settings** screen using ``/settings``. -- Log out of Mattermost using ``/logout``. \ No newline at end of file +- Log out of Mattermost using ``/logout``. From f831dfec0c283d6566f9983b23315e2e72912bef Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Guillermo=20Vay=C3=A1?= Date: Wed, 6 May 2026 12:49:16 +0200 Subject: [PATCH 4/5] docs: refine mobile troubleshooting formatting --- source/deployment-guide/mobile/mobile-troubleshooting.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/source/deployment-guide/mobile/mobile-troubleshooting.rst b/source/deployment-guide/mobile/mobile-troubleshooting.rst index e55f719af57..59457681dcf 100644 --- a/source/deployment-guide/mobile/mobile-troubleshooting.rst +++ b/source/deployment-guide/mobile/mobile-troubleshooting.rst @@ -25,7 +25,7 @@ How do I attach mobile app logs to a message? Use ``/mobile-logs`` to enable an attachment option in the Mattermost mobile app that lets users attach their mobile app logs as a file to any message they send. This helps administrators and support engineers debug mobile-specific issues by providing device-side context that isn't available from server logs alone. The command updates the ``attach_app_logs`` advanced preference and always responds with an ephemeral message visible only to the invoking user. -.. note:: +.. important:: This command requires Mattermost mobile app v2.38 or later. @@ -165,4 +165,4 @@ If you did not receive a push notification when testing push notifications, use To conserve disk space, once your push notification issue is resolved, go to **System Console > Environment > Logging > File Log Level**, then select **ERROR** to switch your logging detail level from **DEBUG** to **Errors Only**. -If push notifications are not being delivered on the mobile device, confirm that you're logged in to the **Native** mobile app session through **Profile > Security > View and Log Out of Active Sessions**. Otherwise, the `DeviceId` won't get registered in the `Sessions` table and notifications won't be delivered. +If push notifications are not being delivered on the mobile device, confirm that you're logged in to the **Native** mobile app session through **Profile > Security > View and Log Out of Active Sessions**. Otherwise, the ``DeviceId`` won't get registered in the ``Sessions`` table and notifications won't be delivered. From bca9dce8aa46683aba3fce36d25b27435c941b0f Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Guillermo=20Vay=C3=A1?= Date: Wed, 6 May 2026 13:20:07 +0200 Subject: [PATCH 5/5] improve description --- source/deployment-guide/mobile/mobile-troubleshooting.rst | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/source/deployment-guide/mobile/mobile-troubleshooting.rst b/source/deployment-guide/mobile/mobile-troubleshooting.rst index 59457681dcf..ae79aadf1e9 100644 --- a/source/deployment-guide/mobile/mobile-troubleshooting.rst +++ b/source/deployment-guide/mobile/mobile-troubleshooting.rst @@ -23,15 +23,15 @@ In line with Microsoft guidance we recommend `configuring intranet forms-based a How do I attach mobile app logs to a message? --------------------------------------------- -Use ``/mobile-logs`` to enable an attachment option in the Mattermost mobile app that lets users attach their mobile app logs as a file to any message they send. This helps administrators and support engineers debug mobile-specific issues by providing device-side context that isn't available from server logs alone. The command updates the ``attach_app_logs`` advanced preference and always responds with an ephemeral message visible only to the invoking user. +Use ``/mobile-logs`` during mobile troubleshooting to let users attach Mattermost mobile app logs to messages. Running ``/mobile-logs on`` shows the **Attach app logs** option in the attachment menu of the message composer, so users can include device-side logs when messaging an administrator or support engineer. Users can also turn this option on or off from the **Report a problem** screen in the mobile app. The command responds with an ephemeral message visible only to the user who ran it. .. important:: This command requires Mattermost mobile app v2.38 or later. -- Enable log attachment for yourself using ``/mobile-logs on``. -- Disable log attachment for yourself using ``/mobile-logs off``. -- Check your current setting using ``/mobile-logs status``. +- Enable **Attach app logs** for yourself using ``/mobile-logs on``. +- Disable **Attach app logs** for yourself using ``/mobile-logs off``. +- Check whether **Attach app logs** is enabled using ``/mobile-logs status``. - System admins can manage the setting for another user by appending a username, such as ``/mobile-logs on @username``, ``/mobile-logs off @username``, or ``/mobile-logs status @username``. .. important::