CupixWorks Support Center

How to Use Annotations in SiteView

How to Use Annotations in SiteView


In SiteView, Annotations give you the ability to add and share detailed information about a specific location inside a pano. Here is a quick overview of how to use this valuable feature.

Configure Annotation Form Templates

Annotation Groups and Form templates can be customized per project by Cupix Support during project onboarding.

An Admin can later add or remove Form Templates for the Project via Account Settings -> Form Templates. Please read the articles on Form Templates for more details.

Annotation Hierarchy

Annotations are organized within Annotation Groups like this:

  • Annotation Group - consists of Form Template(s) and/ or Integration(s) that will be available in SiteView for creating annotations.
    • Capture Date- the day the capture was recorded.
      • Annotation - consists of information (form data, markup, files, and/ or comments) added to a pano on a specific capture date.

Annotation Sidebar

Annotations are available by clicking on this icon on the left side of the screen:

When you click on the icon, the annotation sidebar slides out.

If no Annotation Groups are added to a project, the annotation sidebar will not appear in the SiteView.

Add New Annotation

To add a new annotation:

A. Click on the Add Annotation icon  for the Annotation Group you want to add it to.

B. Click on the Form Template that fits the situation.

C. Once you are in the creation screen, there are a lot of options available to you.

We will use an Asset Tag Form Template as an example of some of the options available. Different Form Templates contain varying options & required fields. Unchanging "default" options are noted.

       1. Cancel Creation (default) - clicking on this will take you back to the annotations list view.

       2. Save (default) - clicking on this button will save the settings you have entered.

       3. Re-Position Annotation (default) - click this to move the location of the Annotation Badge in the pano.

       4. Annotation Badge (default) - the location of the annotation shown as a badge and stick in the pano.

       5. Form Template (default) - two letters or a symbol that stand for the Form Template being used.

       6. Annotation Name (default) - enter a meaningful name for the annotation.

       7. Asset ID - enter the asset ID number.

       8. Type - enter type of the issue.

       9. Date - choose the date the asset was tagged.

       10. Description Text Area - describe the asset.

       11. Link - add a URL.

       12. Attachments (default) - add Markup or upload file.

D. Once you have filled in everything, click on Save.

E. More options will appear in the annotation screen.

       1. Edit (default) - make changes to the annotation.

       2. Resolve (default) - the issue will be marked as done. Note that if clicked on accident, you can Reopen it. Both will generate an email notification to the member assigned to the annotation.

       3. More options (default) - adds the following:

  • Copy URL to the clipboard.
  • Move to either a different Annotation Group or Capture.
  • Export to HTML or BCF formats. (A BIM Viewer must be active to see the BCF option.)
  • Delete the annotation.

       4. Attachments (default) - add Markup or Upload Files.

       5. Comments (default) - add comments to an annotation.

       6. Annotation Badge (default) - here it is shown in its location on the reference plan in the Plan Viewer.

Important individual options are explained further below.

Re-position Annotation

To re-position an annotation in the pano:

  1. Click on the Edit  button.
  2. Click on Re-position Annotation  button.
  3. Available mouse cursor movements:
    • Move the Annotation Badge around in the current view.
    • Left/ right click + hold to move the pano around the Annotation Badge.
    • After finding the new location in the pano, left click to re-position it there.
  4. After re-positioning it, select a distance for the Annotation Badge from your current position, and left click.
  5. Click Save to make the change.

Advanced Re-position Annotation

To re-position an annotation in the pano using stereo-matching with a point:

  1. Click on the Edit  button.
  2. Right click in the Capture Viewer to bring up the option. Left click on Reposition annotation by stereo matching.
  3. Click on a point in the pano to re-position the annotation.
  4. Click on that same point from a different view.
  5. Click on Save to make the change.

Annotations List

Search Annotations

If you have a lot of annotations, use the search bar to find a specific one quickly. 

(Note that it only searches within title or form template fields.)

Filter Annotation Visibility in Plan Viewer

To limit the number of annotations shown in the Plan Viewer, filter by:

  • Status:
    • All
    • Open
    • Resolved
  • Captures:
    • All Captures
    • Current Capture

Annotation Groups List

All Annotation Groups that have been published in the Project Center will appear here.

(Note: if you do not see a group you want to view, contact your Admin.)

Show or Hide Annotation Groups

If you click on the Hide  icon, all annotations in that group will disappear from the Capture and Plan Viewers.

If you click on the Show  icon, they will re-appear.

Share Annotation Group

  1. Click on the three vertical dots.
  2. Click on Share Annotation Group.
  3. This will bring up the Share with Others screen. Choose to add people or change permissions for an Annotation Group here. Note that annotations are shared with all members of the Project.

Export HTML

Export one, some or all captures that contain annotations for an Annotation Group in HTML format.

  1. Click on the three vertical dots.
  2. Click on Export HTML
  3. Click on one of the following options:
    • Current capture only - export the capture you are viewing to compare with annotations in the group.
    • Include following captures - export the capture you are viewing + all following ones to compare with annotations in the group. 
    • Include previous captures - export the capture you are viewing + all previous ones to compare with annotations in the group. 
    • Include all captures - export the capture you are viewing + all others to compare with annotations in the group. 

Annotation Options

To access more options for individual annotations:

  1. Click on the three dots next to the name of the annotation.
  2. Choose one of the following actions:
    • Open
    • Resolve
    • Rename
    • Duplicate
    • Copy URL
    • Move to
    • Export -> HTML or BCF
    • Delete


You can attach two types of files to an annotation:

  • Markup - either take a screenshot of a Capture Viewer or copy an image from the computer's clipboard.
  • Upload Files - add files to your annotation. (Note that the limit per file file is 3GB.)


Use Markups to add freehand drawings, text, and shapes to the annotation.

Upload Files

Upload any files that you want to associate with the annotation.


Add comments and/or links to an annotation to provide more context or ask other team members to assist, etc.

Note that all comments will be emailed to members of the project with Edit level permissions.

Loose Ends

  • Only annotations within 20 feet of the current pano will be displayed in the Capture Viewer.
  • You can click on an annotation in the Plan Viewer to go directly to it.
Matt is the author of this solution article.

Did you find it helpful? Yes No

Send feedback
Sorry we couldn't be helpful. Help us improve this article with your feedback.