Dialog boxes in Office Add-ins

Dialog boxes are surfaces that float above the active Office application window. You can use dialog boxes to provide additional screen space for tasks such as sign-in pages that can't be opened directly in a task pane or requests to confirm an action taken by a user, or to show videos that might be too small if confined to a task pane.

Figure 1. Typical layout for a dialog box

An example image displaying a typical layout for a dialog box

Best practices

Do Don't
  • Include a descriptive title that includes your add-in name along with the current task.
  • Don't append your company name to the title.
  • Don't open a dialog box unless the scenario requires it.

Implementation

For a sample that implements a dialog box, see Office Add-in Dialog API Example in GitHub.

See also