Place and manipulate holograms in the Dynamics 365 Guides HoloLens app

After creating a guide with the PC app in Microsoft Dynamics 365 Guides, the next step in the authoring process is to place the holograms in your real-world environment. During this stage of the process, you'll walk through each step in your guide and place any assets that you associated with that step when you authored it in the PC app. For example, if you added a 3D part to help operators with a step, you'll place that part over its physical counterpart in the real world. If you added a 3D object from the toolkit (for example, an arrow or a number), you'll place that object in an appropriate place where it can draw the user's attention. You can place the same 3D part or 3D object as many times as you want.


You don't have to do anything to place an image or video that you added in the PC app. Images and videos automatically appear when the operator goes to the step.

Place a 3D part

  1. In the bin, air tap the 3D part that you want to place.

  2. Use gaze and gestures to place the 3D part hologram over its counterpart in the real world. Manipulate the hologram if needed.

Place a 3D object from the toolkit

If you added a 3D object to the bin in the PC app, you can place the 3D object in the same way that you place a 3D part. You can also add a 3D object directly from the HoloLens app (you don't have to add it in the PC app first).

  1. Air tap one of the Add boxes in the bin.

  2. Air tap a category (for example, Arrows or Hands), and then air tap the specific 3D object that you want to add.


    The item is added to your bin. You can then place it in the same way that you place any 3D part.

    There are only eight 3D parts boxes in the bin, which limits the variety of 3D objects you can add to a single step. When placing holograms on the HoloLens, you can, however, place an unlimited number from the bin. For example, you can add up to eight different 3D objects (arrows, boxes, nuts, drills, and so on) to the bin, but you can place as many arrows, boxes, nuts, and drills from each 3D Parts box that you want when in HoloLens. Either tap the asset bins to spawn 3D objects or go to a 3D object's Edit menu and select Duplicate.

Best practices for working with 3D content

  • Make sure that the 3D content isn't in the way of the operator who is doing the task.

  • Keep the field of vision in mind when you place your holograms. If you put a hologram behind someone, it will be very hard to find.

  • Use 3D content sparingly and for a clear purpose. Too much content can clutter the instructions and make them harder to follow.

  • Remember that you can attach a dotted line to 3D content to make it more discoverable.

  • See tips for pointing at small, closely spaced objects in the real world.

Manipulate holograms

To place a 3D object from one of your bins, follow these steps.

  1. Air tap a 3D object to add it to the real world. It appears in front of the Step card in your world.

  2. Raise your hand in the ready gesture and gaze at the model to preview it. To place a model, you must look at the model and put your hand up into the ready position. You'll know that the model is in a preview state when the 3D controls appear around it.


    If you put your hand down, the 3D controls disappear. This is a good way to view the holograms by themselves without the controls getting in the way.

  3. While the 3D controls are visible:

    1. Air tap and hold anywhere on the move control.

    2. Move the model where you want it to go, and then release to place it.

    When you tap a 3D object to move it, you select it at the same time. After a 3D object is selected, if you put your hand down, the 3D controls remains until you preview or select another part, or until you air tap somewhere in empty space.


On HoloLens 2, you can manipulate holograms directly with your hands. To select a hologram, place your hand on it to show the 3D controls. Then grab the hologram, move it, and release to place it. When you've finished, air tap anywhere in an empty space. For more information about how to manipulate holograms in HoloLens 2, see Authoring and navigating gestures for HoloLens 2.

Rotate a hologram

It's unlikely that an asset is correctly oriented when you first place or move it. You can use the rotation controls to rotate it the way that you want.

To rotate a hologram:

  • Air tap and hold a rotation control, and then follow one of these steps:

    • Use the up/down sphere to rotate vertically.

    • Use the left/right sphere to rotate horizontally.

    • Use the free-hand sphere to rotate in any direction.


    You can gaze at any sphere to determine rotation direction.

    When you're using a rotation control, it's helpful to imagine that you're physically grabbing the sphere and rotating around the object, like a wheel.

The following illustrations show how to use the different rotation controls.

Free rotation

Free rotation.

Left/right rotation

Left/right rotation.

Up/down rotation

Up/down rotation.


On HoloLens 2, you can operate the rotation controls with your hands. Pinch one of the available rotation controls with your hand, and then rotate the hologram the way that you want. For more information on manipulating holograms in HoloLens 2, see Authoring and navigating gestures for HoloLens 2.

Change the size of a hologram after you place it

  • Air tap and hold the Scale Hologram control, and then move your hand up or down.

    Scale Hologram control.


    On HoloLens 2, you can pinch the Scale Hologram control with your hand, and then move it up or down to change the size of the hologram.

Next steps