Customize an immersive event in Microsoft Teams

Se aplica a
Microsoft Teams

Customize environments in immersive events to tailor the event space to your needs. Boost engagement by adding your own content and making the experience unique to your scenario.

Screenshot showing custom 3D elements in an immersive event environment.

Customize an environment

Make immersive events more impactful with ready-made templates and no-code tools that help you design 3D environments featuring your brand, images, videos, 3D models, and more.

Only organizers and co-organizers can customize the event when scheduling it in Teams. Any changes to the event space must be saved at least 10 minutes before the event starts.

Important

  • If you plan on adding custom content to your event, set up a SharePoint or OneDrive folder before the event with the content you plan to use. This will ensure easy access to URLs when adding objects to your event.
  • Direct upload of content files for customization isn't supported.
  • Customizing an event is unavailable after the event has already been started once.

1. Join the customization session

To start customizing an immersive event space, join the customization session by editing the event in your Teams calendar. In the customization session, you'll appear as an avatar in the environment you selected when scheduling the event. 

To join the customization session for an immersive event:

  1. Select Calendar teams-calendar-tab-icon in Teams.
  2. Double-click an immersive event.
  3. Select Manage event edit-pencil-icon-20x20-png .
  4. At the top of the event details, select More actions more-options-ellipsis Customize in immersive edit-pencil-icon-20x20-png .
  5. Select Join now to enter the customization session.

Important

The Customize in immersive edit-pencil-icon-20x20-png option will be unavailable 10 minutes before the event start time.

2. Edit the immersive event space

Once you're in the customization session, you can start making changes to the environment around you.

To change the event space:

  1. Select Editor in the menu bar.

    Screenshot highlighting the editor in an Immersive event space.

  2. In Editor, select Add an object to the environment plus-icon-teams .

  3. In Catalog, select an object to add it to the environment.

  4. Select the gizmo at the center of the object to reposition, resize, or move it.

    Screenshot showing the resizing and positioning tool for Immersive event objects.

  5. Configure other object details, like its Visibility, whether it's Enabled and active during the event, and more.

  6. To delete an object, select Delete Delete button trashcan icon  in the object's row in Editor.

3. Add custom content objects

From the Catalog, add custom images, 3D models, and more from OneDrive or SharePoint.

To add custom objects:

  1. In Editor, select the object type you want to add to your space (i.e., Image, 3D Model, Video, Audio).

  2. In your web browser:

    1. Open the OneDrive or SharePoint file folder with content you saved to add to the space.

    2. Hover over a file and select Share od-share-icon > Copy link  teams-insert-link-button-icon  to copy the URL.

      Important

      Make sure the expected audience of your event has access to the file in OneDrive.

  3. In the customization session, paste the content's URL into the URL field on the object details panel. 

    Screenshot showing how to add a URL to a custom object in Immersive events.

  4. Press Enter to load the content.

Repeat the steps above to create your experience.

Tip

  • For the best event experience, add three or more objects containing content relevant to your scenario. 
  • To create an interactive experience, use action groups to connect multiple objects and control how they're displayed. This allows you to display sequences of object content for the audience.

4. Save your changes

When you finish customizing the environment, save your changes by selecting Save save-icon-001 in the menu bar. After you save, your changes will remain even if you leave the customization session. 

Customizations can be saved to a single event but can't be reused across multiple events.

Important

Make sure to save all customizations at least 10 minutes prior to the event start time.

Customizable objects

There are many options for adding objects to your event. Any event can have multiple objects. You won't be able to preview your objects during the customization session but you can join the event early to preview them.

Screenshot showing how to customize objects in immersive events.

Learn more about what each object does and how you can customize it.

Object What it does Customizable options
Screenshare Allows presenters or participants to share their screen content with the immersive environment.
Screenshare audio isn't supported.
  • Enabled: Determines if the object is active when the event starts.
Social ice breaker Generates random icebreaker questions to facilitate conversations and help people get to know each other better.
  • Show in order: Determines if questions go in a sequential order or if they're randomized.
  • Question index (0-52): The number of questions available from the ice breaker.
  • Enabled: Determines if the object is active when the event starts.
Spotlight point: attendee Determines where an attendee will appear and the direction they'll face when they're called on after raising their hand.
  • Point the arrow in the direction you want the attendee to face when they're called on.
Spotlight point: organizer Determines the location and orientation of an organizer when they broadcast.
  • Point the arrow in the direction you want your audience to face.
Seat Represents a virtual seating position that participants can occupy during the event.
  • Assigned seat: A seat that attendees can be teleported to when Seat attendees is turned on.
  • Open seat: A seat that attendees won't be teleported to when Seat attendees is turned on.
  • Enabled: Determines if the object is active when the event starts.
Text Displays static or dynamic text within the environment, often used for labels, instructions, banners, or titles.
  • Text: Add text to appear in the object.
  • Backplate: Turn the backplate of the text on or off.
  • Autosize: Text scales with the size of the object.
  • Text scale: Change the size of the text.
  • Alignment: Align the text to the left, center, or right.
  • Text style: Set the text style to bold, dark mode, or title size.
  • Enabled: Determines if the object is active when the event starts.
3D model (.glb file) Renders and displays 3D models in the environment using the .glb format. Participants can view and interact with it.
  • URL: where you input a URL link to a 3D model.
  • Loop animations: Choose if a selected animation loops.
  • Animation: Choose the animation that will play. Depends on the animation in the .glb file.
  • Enabled: Determines if the object is active when the event starts
Audio player (.mp3 file) Plays audio clips (e.g., music, narration) embedded in the environment.
  • URL: Where you input a URL link to the audio file you want played.
  • Volume: Set the volume the audio will play at.
  • Looping: Allow automatic audio replay when the track finishes playing.
  • Enabled: Determine if the object is active when the event starts.
Spawn point Determines where an attendee appears and what direction they're looking in when they join an immersive event.
  • Access level: Choose whether attendees, organizers, or everyone can spawn at that location.
  • Enabled: Determine if the object is active when the event starts.
  • Point the arrow in the direction you want the attendee to face.
Image (.png, .jpeg file) Displays 2D images within the environment and is useful for branding, signage, or visual aids.
  • URL: Where you input a URL link to the image you want to display.
  • Backplate: Turn the backplate behind the image on or off.
  • Enabled: Determines if the object is active when the event starts
Video player Plays video content on virtual screens or surfaces within the immersive environment.
  • URL: Where you input a URL link to the video you want to display.
  • Volume: Set the volume you want the video played at.
  • Backplate: Turn the backplate behind the video on or off.
  • Looping: Determines whether the video will loop when it's done playing.
  • Enabled: Determines if the object is active when the event starts
Text button Triggers other objects to be played as part of an action group.
  • Text: Add a button name or descriptor.
  • Auto size: Set whether the text button resizes automatically based on the amount of text placed.
  • Text size: Set the font size using a scale from 1-100.
  • Triggers: Choose who can trigger the object, see the triggers play, and configure which action group plays when the button is selected.

Action groups in immersive events

 Build interactive experiences without coding. Create opportunities for dynamic audience engagement by allowing them to trigger animations, sounds, and visual cues during live events.

There are endless creative possibilities with action groups. For example:

  • Event welcome moments: Turn on audio, add a welcome image and confetti, and start a screenshare.
  • Show a jet engine working: Use a button to trigger a model of a jet engine to appear, starts its animation, and play audio.
  • Take a casual quiz: Write a question on the wall and place answer buttons to show an image of a checkmark or incorrect answer.
  • Run a show with content switches: Switch URLs for images and videos to display new content to your attendees during an event.

With action groups in immersive events, you can create interactive experiences without writing code. Control object states and trigger sequences during an event automatically or via clickable buttons.

Object states include:

  • Enabling or disabling objects (e.g., show/hide a 3D model)
  • Controlling animations (start, stop, loop)
  • Playing or stopping media (audio, video)
  • Switching URLs for media dynamically

Group actions together and connect them to a button or play them from the action groups panel during a live event.

Object type State options
Audio Enabled, play state, volume, URL
Icebreaker Enabled
3D model Enabled, animation, looping
Text Enabled, text
Video player Enabled, play state, volume, URL, looping
Screenshare Enabled
Text button Enabled

Create action groups

  1. In a customization session, add objects to your space.

  2. Select Action groups in the menu bar.
    Screenshot showing how to open immersive event customization tools.

  3. Select Create new action group plus-icon-teams , name your group, and select OK.
    Screenshot showing how to create a new action group in an immersive event.

  4. Select Add content plus-icon-teams to specify an object.
    Screenshot showing how to specify an object in an immersive event.

  5. Select the object in the list and select its controls.
    Screenshot showing how to modify object controls in an immersive event.

    Note

    In this example, the 3D model is disabled and won't be visible in the space. The action group will enable it once the action group is triggered, so the enabled state is turned on. Also, the animation will start looping once the action group is on. 

  6. Add any additional objects to the action group by repeating steps 4-5.

Submit feedback

To submit feedback about your immersive event experience, select Menu teams-app-launcher-inversed-button-waffle-icon  > Give feedback give-feedback-icon inside the immersive event. 

To give feedback about the Teams experience, such as scheduling or the event window (including the Join screen and features like audio, chat, or screenshare), select Settings and more generic-ellipsis-button-icon  > Report a problem report-a-problem  in the top-right corner of your Teams event window.

Upload and save files and folders to OneDrive

Share SharePoint files or folders

Host an immersive event in Microsoft Teams