How to show a pop-up in SharePoint

This post was most recently updated on July 27th, 2022.

This ages-old trick deserves to be published – since it makes it easy to quickly show info from pretty much any other page on pretty much any Classic SharePoint page (in a SharePoint-compatible pop-up). So, here goes:

Using SharePoint’s JavaScript library to open an arbitrary pop-up

Yes – SharePoint contains all the functionality out-of-the-box, and you almost don’t have to do anything yourself! Let’s see how this works.

Okay – long story short. On all Classic SharePoint pages, you can call this function: SP.UI.ModalDialog.ShowPopupDialog(). Like it says, it quite simply just opens a pop-up dialog, showing the page that it finds from the URL.

See below for a simple example:

<!-- Opens a pop-up -->
<a onclick="javascript:SP.UI.ModalDialog.ShowPopupDialog('https://yourtenant.sharepoint.com/sites/intranet/Pages/default.aspx')">Show more!</a>

What’s cool about this, is that you can show pretty much any page (that allows it) in this pop-up! For an example, see below.

This works in SharePoint Online, SharePoint 2010, SharePoint 2013, SharePoint 2016, and even SharePoint 2019… As long as you’re using Classic SharePoint, you should be good! The best part is that it’s ridiculously easy.

How to show SharePoint pages in pop-ups?

But let’s imagine a different use case – showing another SharePoint page in a pop-up. You can use the same function for that!

This is very useful for showing other SharePoint pages in the context of whatever page the user is currently browsing. For example, this could look something like this:

As you can probably imagine, showing just “any” page in SharePoint in a pop-up might also cause weird layout issues. This is especially true with out-of-the-box SharePoint sites, that is not responsive – they won’t always play nice in a pop-up! Luckily, the code for showing that pop-up appends the ?IsDlg=1 to the URL of the page, to hide the chrome of the page. That makes the page act a lot nicer.

If this doesn’t work for whatever reasons, you should modify the URL you’re passing to the method to include “IsDlg=1” as a parameter. See this post for more details:

The following script example shows how to use this:

<!-- Opens a pop-->
<a onclick="javascript:SP.UI.ModalDialog.ShowPopupDialog('https://yourtenant.sharepoint.com/sites/intranet/Pages/default.aspx?IsDlg=1')">Show more!</a>

Showing responsive SharePoint pages in pop-ups

However, if you’re using responsive styles in your SharePoint site, it might work reasonably well (even though the pop-up is going to be pretty cramped). Below, there’s a decent example of that:

One thing to note, however, is that you customize the size of the pop-up to offer more space for the contents. To achieve this, you’ll have to change the method call you’re using, though!

Next, let’s take a look into how to do that…

How to customize the pop-up in SharePoint?

You can actually tweak how the pop-up works in quite a few different ways. If you call .showModalDialog() instead of .ShowPopupDialog() (it’s interesting that Microsoft decided to deviate from camelCase there!), you can replace the “URL” property (basically just the URL as a string) in the method call with an object containing any of the following properties. Only the “URL” or “HTML” property is required, everything else is optional.

Below, I’ve gathered the different configuration values you can pass on to the function. You’ll need to add them as additional properties for the “options” object – let’s see how that works!

Documentation of .showModalDialog()’s options:

Okay – how to use this new knowledge in practice? See below for an example!

Example of a SharePoint pop-up with custom options

If you decide to open the pop-up with options, your code might look something like this:

var options = SP.UI.$create_DialogOptions();
 
options.title = "A standard SharePoint Publishing site in a dialog will look funky.";
options.width = 400;
options.height = 600;
options.url = "https://yourtenant.sharepoint.com/sites/publishing";

// Note the different casing here:
SP.UI.ModalDialog.showModalDialog(options);

Simple and straightforward!

Links and References

See these 2 MSDN articles for more info:

• SP.UI.ModalDialog.ShowPopupDialog(url) -Method
• SP.UI.ModalDialog.showModalDialog(options) -Method

• Author
• Recent Posts

Antti K. Koskela

Developer / Speaker / Consultant at Koskila / Precio Fishbone / Norppandalotti Software Co / Alter - Experience Ideas Ltd

Antti Koskela is a proud digital native nomadic millennial full stack developer (is that enough funny buzzwords? That's definitely enough funny buzzwords!), who works as Solutions Architect for Precio Fishbone, building delightful Digital Workplaces.

He's been a developer from 2004 (starting with PHP and Java), and he's been working on .NET projects, Azure, Office 365, SharePoint and a lot of other stuff. He's also Microsoft MVP for Azure.

This is his personal professional (e.g. professional, but definitely personal) blog.

Latest posts by Antti K. Koskela (see all)

• “Performing cleanup” – Excel is stuck with an old, conflicted file and will never recover. - November 12, 2024
• How to add multiple app URIs for your Entra app registration? - November 5, 2024
• How to access Environment Secrets with GitHub Actions? - October 29, 2024