A feature many people have been excitedly waiting on is custom Microsoft Teams background images and effects. This feature allows people to replace their background with a fun image; it’s usually a great way to show off some personality and a great conversation starter in a meeting.

Microsoft Teams includes some default backgrounds, but people quickly figured out how to upload their own images. Allowing users to upload images can cause some heartburn with system administrators and human resources as people can always ruin something fun by uploading inappropriate backgrounds. Initially, Microsoft Teams background images released without any administrator controls, but administratos can now control which Teams background effects are available to users.

Staging Custom Microsoft Teams Background Images

First, I need some images to use as my custom Teams backgrounds. I love visiting national parks and have taken some pretty good landscape pictures, and I want to use these during meetings. You can add custom Microsoft Teams background images in two different ways.

If you are using a Windows desktop, you can navigate to:

%AppData%\Microsoft\Teams\Backgrounds\Uploads

And copy some images into this folder. Here are my 8 landscape pictures I want to use as my custom backgrounds.

windows explorer files
Placing custom backgrounds into the Upload folder

If you are already in a meeting, you can upload your own background image directly to the Microsoft Teams client. In the meeting window, select the 3 dots to bring up additional options, then select Apply background effects. From here, select the + Add new option to browse your system for the image.

microsoft teams client options
microsoft teams background settings

After uploading from the client or placing files in the Uploads folder, my custom images are available at the bottom of the list after the default images (only 6 of my 8 images are displayed in the screenshot but all 8 were available):

microsoft teams background settings
Choosing custom background image and previewing the video


Creating the Meeting Policy

Next, you can create a new meeting policy using a new property named VideoFiltersMode. This property has four options available for values:

  • BlurOnly: offer background blur only
  • BlurAndDefaultBackgrounds: offer background blur and default-provided images
  • AllFilters: All, which includes the ability for Teams to use custom images
  • NoFilters: offers no background effects or filters

Right now this meeting policy is only available by creating a remote PowerShell session out to Skype for Business Online. Microsoft recently introduced the capability to connect to Skype for Business Online in the Microsoft Teams PowerShell modules. To learn more, check out my article Exploring New Functionality in the Microsoft Teams PowerShell Module.

For my first meeting policy, I’m going to go with BlurAndDefaultBackgrounds so I can test and see if Teams will ignore my custom backgrounds in the Uploads folder. Let’s create a new meeting policy using the New-CsTeamsMeetingPolicy command:

New-CsTeamsMeetingPolicy -Identity BlurAndDefaultEffects -VideoFiltersMode BlurAndDefaultBackgrounds
powershell new-csteamsmeetingpolicy
Creating a Teams meeting policy using VideoFiltersMode property

Once the policy is created, I will assign it to my user account using the Grant-CsTeamsMeetingPolicy command:

Grant-CsTeamsMeetingPolicy -Identity <user ID> -PolicyName BlurAndDefaultEffects
powershell grant-csteamsmeetingpolicy
Assigning meeting policy in PowerShell


Testing the Policy

After assigning the policy, I waited about one hour to see if the policy had taken effect. So far it did not, so I left it for the rest of the day. Later, I went to enable background effects and my images were not longer available by scrolling to the bottom of the images list:

microsoft teams background images
Custom images are missing

So somewhere in that 24 hours the policy took effect. This has always been an issue when applying policy changes inside of Microsoft Teams; there is sometimes a significant delay in them taking effect. This is why I suggest configuring the VideoFiltersMode on a new or existing policy now.

Let’s try again with just a blur only policy so default and custom images are both not available.

New-CsTeamsMeetingPolicy -Identity BlurOnly -VideoFiltersMode BlurOnly

Grant-CsTeamsMeetingPolicy -Identity <user ID> -PolicyName BlurOnly
Creating and assign blur only meeting policy
Creating and assigning blur only policy

This time I checked more frequently for when the policy takes effect. My testing process is to test the policy, and if it isn’t taking effect, sign out and exit the client. After trying this every now and then for about 2 hours, the policy took effect. When I got to enable background effects in a meeting, only the blur option is available.

Only blur background effect available in the meeting
Only blur background effect available in the meeting


Teams Admin Center Configuration

Right now the ability to set the video filter effect is not available in the Teams admin center under meeting policies. The assumption is it will be a configurable option in the future, but these new controls typically come to PowerShell first.

However, policies you create in PowerShell are available in the portal so you don’t have to drop out to PowerShell to assign them. Here are my policies under Meetings > Meeting Policies:

microsoft teams admin center meeting policies
Custom meeting policies created in PowerShell are available in Teams admin center

These policies are also available for assignment when going to an individual user, selecting the Policies tab and opening the Edit menu:

Assigning a meeting policy in Teams admin center
Assigning meeting policies on user account


Questions or comments? If so, drop me a note below or find me on Twitter or LinkedIn to discuss further.

This Post Has One Comment

Leave a Reply