I have a problem with my outlook add-in, I put some buttons on the ribbon but they only show on the classic outlook, the new one and the web one don't show them.

Nathan Rosales 0 Reputation points
2026-01-31T19:50:50.86+00:00

I have a problem with my outlook add-in, I put some buttons on the ribbon but they only show on the classic outlook, the new one and the web one don't show them.

This is the part of my unified manifest, I removed some parts of restricted data:

"extensions": [

    {

        "requirements": {

            "capabilities": [

                {

                    "name": "Mailbox",

                    "minVersion": "1.3"

                }

            ],

            "scopes": [

                "mail"

            ]

        },

        "runtimes": [

            {

                "requirements": {

                    "capabilities": [

                        {

                            "name": "Mailbox",

                            "minVersion": "1.3"

                        }

                    ]

                },

                "id": "TaskPaneRuntime",

                "type": "general",

                "code": {

                    "page": "https://localhost:3000/office/TaskPaneShell.html"

                },

                "lifetime": "short",

                "actions": [

                    {

                        "id": "TaskPaneRuntimeShow",

                        "type": "openPage",

                        "pinnable": false,

                        "view": "dashboard"

                    }

                ]

            },

            {

                "id": "CommandsRuntime",

                "type": "general",

                "code": {

                  "page": "https://localhost:3000/office/commands.html",

                  "script": "https://localhost:3000/office/commands.js"

                },

                "lifetime": "short",

                "actions": [

                    {

                        "id": "action",

                        "type": "executeFunction"

                    }

                ]

            }

        ],

        "ribbons": [

            {

                "contexts": [

                    "mailRead"

                ],

                "tabs": [

                    {

                        "builtInTabId": "TabDefault",

                        "groups": [

                            {

                                "id": "msgReadGroup",

                                "label": "Test",

                                "icons": [

                                    {

                                        "size": 16,

                                        "url": "https://localhost:3000/office/assets/icon-16.png"

                                    },

                                    {

                                        "size": 32,

                                        "url": "https://localhost:3000/office/assets/icon-32.png"

                                    },

                                    {

                                        "size": 80,

                                        "url": "https://localhost:3000/office/assets/icon-80.png"

                                    }

                                ],

                                "controls": [

                                    {

                                        "id": "msgReadOpenPaneButton",

                                        "type": "button",

                                        "label": "Test",

                                        "icons": [

                                          {

                                            "size": 16,

                                            "url": "https://localhost:3000/office/assets/icon_16.png"

                                          },

                                          {

                                            "size": 32,

                                            "url": "https://localhost:3000/office/assets/icon_32.png"

                                          },

                                          {

                                            "size": 80,

                                            "url": "https://localhost:3000/office/assets/icon_80.png"

                                          }

                                        ],

                                        "supertip": {

                                            "title": "Test",

                                            "description": "Open the Test task pane."

                                        },

                                        "actionId": "TaskPaneRuntimeShow"

                                    },

                                    {

                                        "id": "ActionButton",

                                        "type": "button",

                                        "label": "Perform an action",

                                        "icons": [

                                            {

                                                "size": 16,

                                                "url": "https://localhost:3000/office/assets/icon-16.png"

                                            },

                                            {

                                                "size": 32,

                                                "url": "https://localhost:3000/office/assets/icon-32.png"

                                            },

                                            {

                                                "size": 80,

                                                "url": "https://localhost:3000/office/assets/icon-80.png"

                                            }

                                        ],

                                        "supertip": {

                                            "title": "Perform an action",

                                            "description": "Perform an action when clicked."

                                        },

                                        "actionId": "action"

                                    }

                                ]

                            }

                        ]

                    }

                ]

            }

        ]

    }

]
Microsoft 365 and Office | Development | Other
0 comments No comments
{count} votes

2 answers

Sort by: Most helpful
  1. Michelle-N 12,505 Reputation points Microsoft External Staff Moderator
    2026-02-01T09:35:15.6333333+00:00

    Hi @Nathan Rosales

    Thank you for reaching out to the Q&A Forum.

    Based on the information you shared, I understand that your issue is that the buttons you added to the Outlook ribbon only appear in Classic Outlook, but do not show up in New Outlook or Outlook on the web.

    After doing some research, this behavior is expected due to platform differences, and it is important that the Unified Manifest (JSON format) is configured correctly for commands to appear across different Outlook versions. You currently have two buttons:

    -One button to open a Task Pane (“Test”)

    -One button to execute a JavaScript function (“Perform an action”)

    From your manifest, the runtime configuration appears mostly correct:

    -TaskPaneRuntime: This runtime is of type general with lifetime: short and is used for opening the task pane. It includes an action with "id": "TaskPaneRuntimeShow" of type openPage, pointing to the task pane HTML page (e.g. TaskPaneShell.html). This part is already configured correctly.

    -CommandsRuntime (for executeFunction actions): The button with "actionId": "action" must correspond to an action with the same ID defined in this runtime, and the function must be associated in commands.js using Office.actions.associate(...). Please verify that this association exists.

    Regarding the Ribbon configuration, this section determines whether buttons appear only in Classic Outlook:

    -You are using "contexts": ["mailRead"], which means the buttons will only appear when reading an email. This is correct for your intended behavior. If you want the buttons to also appear while composing an email, you will need to add "mailCompose" to the contexts (and define the corresponding command group).

    However, to support New Outlook and Outlook Web, you should additionally define Command Surface controls, which:

    Do not belong in ribbons and must be defined directly under extensions

    For example:

    "extensions": [
     {
       ...
       "controls": [
         {
           "id": "msgReadOpenPaneButton",
           "type": "button",
           "label": "Test",
           "contexts": ["messageRead"],
           "actionId": "TaskPaneRuntimeShow"
         }
       ]
     }
    ]
    
    

    You can refer to the following Microsoft documentation:

    extensionRibbonsArray object | Microsoft Learn

    Additionally, based on reports from other users experiencing the same behavior, add-ins may not appear in New Outlook or Outlook Web if the manifest does not define appDomains correctly. Several users reported that once the correct appDomains entries were added, the issue was resolved.

    You may find the following documentation helpful:

    AppDomain element in the manifest file | Microsoft Learn

    Since I don’t have access to your environment or tenant configuration, I’ve shared the most relevant guidance and documentation available. I hope this information helps resolve the issue.

    Please feel free to let me know if you need further assistance.


    If the answer is helpful, please click ""Accept Answer"" and kindly upvote it. If you have extra questions about this answer, please click ""Comment"".

    Note: Please follow the steps in our documentation to enable e-mail notifications if you want to receive the related email notification for this thread.


  2. Q&A Assist
    2026-01-31T19:51:00.8133333+00:00
    AI generated content. This question contains an answer created with AI from Q&A Assist. Learn more

    It seems that your Outlook add-in buttons are not appearing in the new Outlook and web versions due to the requirements specified in your manifest. Here are a few things to check:

    1. Minimum Version: You have set the minVersion to 1.3 for the Mailbox capability. Ensure that the new Outlook and web versions support at least this version. If they do not, you may need to adjust the minVersion to a lower version that is compatible with those platforms.
    2. Ribbons Contexts: You are using the mailRead context for your ribbon. Make sure that this context is supported in the new Outlook and web versions. If not, you may need to add additional contexts that are supported.
    3. Testing on Different Platforms: It's important to test your add-in on the specific platforms where you want it to work. Sometimes, features behave differently across Outlook versions and platforms, so ensure that you are testing in the correct environments.
    4. Manifest Configuration: Review your manifest configuration to ensure that all required properties are correctly set and that there are no missing elements that might prevent the buttons from appearing.
    5. Publishing and Deployment: If you have made changes to your manifest, ensure that your add-in is properly published and deployed to the Microsoft 365 Admin Center, as changes may not reflect until the add-in is updated in the environment.

    By addressing these points, you should be able to troubleshoot the visibility of your buttons in the new Outlook and web versions.

    0 comments No comments

Your answer

Answers can be marked as 'Accepted' by the question author and 'Recommended' by moderators, which helps users know the answer solved the author's problem.