HoloBuilder Markups are annotations you can add to your 360° images. They can be used to visually highlight specific details or areas within a scene for better documentation and collaboration.
Markups can be a very helpful tool when informing stakeholders about detailed information within a project, and can also be used for advanced collaboration and issue management with the right integration.
This tutorial will show you how to do the following in the Web Editor:
Add new Markups - learn more
Edit the Markups - learn more
Delete & Modify the Markups object - learn more
Note: All project members with a Project Editor or Admin role as well as the related Project Manager, any related Group Managers, and the Enterprise Admins can create and adjust Markups in the Web Editor or JobWalk app. Only Project Editors, Admins, and the Manager of the project can be set as 'Assignee' of a Markup.
Access the Markups tools in the Web Editor
Open the Markups tool list by clicking on the Markup icon 🖊️ on the right side of the Web Editor. The tools will be expanded to the left.
Note: Click again on the 'Markups' icon to close the Markup tools again.
Markup drawing types
There are six different markup drawing types that can be used to annotate a 360 image.
☁ Cloud drawing
Highlight areas with the standard cloud form also available, e.g., in certain drawing management tools. Each cloud drawing will be saved as an individual markup object to be moved or edited individually.
▢ Equirectangular drawing
Add any equirectangular form to mark something in the scene. The form can be stretched freely and adjusted to a square. Each equirectangular drawing will be saved as an individual markup object.
Circle aspects in a scene with a regular circle or ellipse. Each circular drawing will be saved as an individual markup object to be moved or edited individually.
Draw individual lines in the scene. Each linear drawing will be saved as an individual markup object to be moved or edited individually.
Point out details in the scene with individually adjustable arrows. Each arrow drawing will be saved as an individual markup object to be moved or edited individually.
∿ Free-hand drawing
Draw freely in the scene to not be limited to a given form. There are no limitations in the form of free-hand markups.
Please note that all brushstrokes of a free-hand drawing will be saved together as a single 3D object unless you terminate the drawing session. Complete the drawing by closing the markups tools or selecting again the "Free-hand" tool. To start a new free-hand drawing simply open the markups tools again and proceed like before.
Adding a Markup in the Web Editor
Markups can be added in any 360° scene, be it a photo or a 360 rendering:
Open the 360 image you want to annotate with a Markup.
Rotate your view in your 360° scene to the area you want to mark something.
Note: Once you have the 360 markup tools expanded, you cannot rotate the view of the 360° scene anymore. In order to adjust the view, you need to select the 'Pointer' tool from the options.
Open the Markups tools menu on the right-hand side.
Select a Markup drawing type from the expanded tools menu.
Draw in the 360° image to highlight a certain area. Repeat to add one or more markups in a single 360 image.
Once the markup was drawn, a modal will open to enter some information for your markup. Fill in the details as required:
Markup Title* (required) - Short description of the documented item.
Assignee - Person responsible for working the highlighted item.
IMPORTANT: Only project team members with a Project Editor, Project Admin, and Project Manager role on the corresponding project will be able to be assigned to a Markup.
Status - Set and adjust the status of a Markup as 'Open', 'In Progress', 'To Review', or 'Resolved'.
Due Date - Specify a date when the highlighted item should be resolved.
Information- - Add any further details to the description of your Markup to keep as a record.
Confirm the markup details by clicking 'Save'.
IMPORTANT: In order to actually save this change of adding this markup in your project in the Web Editor, you need to save the full project with the 'Save' button in the upper left corner of the editor. Only then it will actually be saved to your HoloBuilder project and available to anyone else of the team.
Note: It is also possible to add new markups directly on-site with the JobWalk app. Learn more on how to add markups directly with the JobWalk app while capturing on site here.
Save the project - use the 'Save' button in the upper left corner of the web editor to confirm your changes on the project and save them. Only then any additonal markups or changes on existing markups will become visible to the rest of the project team.
Upon saving the over all project, the "Creator", as well as the "Assignee" of the Markup, will receive an automated email with the details of the Markup once it was saved.
Edit the Markup details in the Web Editor
To edit an existing Markup in a HoloBuilder project in the Web Editor:
Open the 360 image where the Markup is located in your project.
Note: You can use the Markups List to help you find any Markups in your project - learn more here.
Select to edit the chosen Markup:
Option 1: Right-click on the Markup in the 360 image to open the context menu & select "Edit Markup Details".
Option 2 (if the Markups List was used): Click on the 'Pen' icon in the "Created At" column of your selected Markup in the list.
In both cases, the modal to view and edit the details of the Markup will show as when creating a new Markup (see above).
Confirm your changes.
IMPORTANT: In order to actually save the change on this markup in your project in the Web Editor, you need to save the full project with the 'Save' button in the upper left corner of the editor. Only then it will actually be saved to your HoloBuilder project and the changes will be available to anyone else on the team.
Save the changes on the Markup with the 'Save' button in the upper left corner of the Web Editor - the "Creator" of the Markup, the "Assignee" of the Markup as well as the person making the changes on the Markup will receive an automated notification email to inform about what was changed.
Note: The fields where a change was made, will be highlighted in green.
Delete and modify Markups in the Web Editor
Each markup will be added as an individual editable 3D object into the 360 image which can also be deleted or modified.
Modify your Markups
You can modify your Markups to move, rotate, and scale as needed. Additionally, you can also change the color. Learn more about your modification options in the HoloBuilder Web Editor in this tutorial.
Delete a Markup
In order to remove a Markup from your project, select the corresponding Markup in the 360 image and click on the recycling bin that appears in the menu on the right.
Alternatively, you can open the context menu by right-clicking the Markup and selecting "Delete".
Confirm if you are really sure you want to delete the selected issue. Please note that deleting a markup cannot be undone and will be a permanent change.