Custom Annotation Markers
This feature is limited to Professional accounts only.
Custom Annotation Markers enable you to create your own icon images as Annotation Markers. This allows you to use icons and markers that are more appropriate for your use cases. They can also be used as markers on Plan Drawings.
Adding a marker
You can add a marker from two places:
- Create/Edit Annotation panel: You can add a marker from the annotation marker dropdown in the Create/Edit Annotation panel; select the "Add/Edit Custom Markers" option.
- Account Details page: You can also add markers from your Account page: Scroll down to the Customizations section; under Annotations click the "Manage Annotation Markers" link.
Adding a marker only requires two steps: Uploading marker images and setting properties
1. Upload Marker Images
You'll need to have your icon images as either PNG or SVG (PNG is preferred), ideally sized to 512 x 512. Make sure the PNG has a transparent background.
Each marker requires three images, corresponding to what is displayed depending on how viewers interact with the annotation. The images are:
- Normal state: What the annotation looks like when it is not selected nor being hovered over
- Hover state: What the annotation looks like when the viewer is hovering over it (a preview panel appears during this state.)
- Selected state: When the viewer has selected the annotation and its contents are being displayed in the annotation details panel
For example, for a left-arrow icon :
This would translate to the following in an annotation:
Although it is possible to use the same icon image for all three states, this is not recommended as viewers won't be able to tell if your annotation is working or not.
To upload, simply click the "+" field above each or drag each image to its appropriate field. You will optionally be able to crop your uploaded image before you upload it if you wish.
If you want to remove an uploaded image, click the "x" button in the upper right corner of the box:
Once you have all three image uploaded, click "Next."
2. Set Marker Properties
Name: The next step is to set the marker's name. This is what will display in the Marker dropdown. (Note: Custom Markers are listed alphabetically in the Marker selector dropdown)
Position: This determines where the annotation marker is placed relative to where you click to place the annotation. Some markers make more sense if they are centered over the click point; some markers make more sense if they are placed above (e.g. pushpin) or below (e.g. up arrow) where you click. The default is centered.
There is a small circle with an "x" that will show you the location of the annotation click and where the marker will be positioned relative to that. You can always change this later.
Editing an existing marker
You can edit an existing marker from the same locations where you add markers; simply select the "Manage Custom Markers" option.
The existing markers that are there will be displayed on the left in a scrollable panel.
1. Selecting the icon you want to edit in the left panel in order to display its details.
2. Click the "Edit Marker" button. This will bring you into the same steps as the marker creation process, except everything will is already populated.
3. Review/edit images; replace if needed, then click next
4. Make adjustments to the name or marker position
5. Click "Save Marker" to save the changes.
All annotations using that marker will now display using the updated marker.
Deleting a marker
To delete a marker, simply go to the Manage Marker panel, select the marker and click the "Delete Marker" button.
All annotations that use the deleted marker will revert to using the default Annotation marker ("Square"). Deleting a marker does not affect any annotation content.
Using Custom Annotation Markers
To use a Custom Marker in an annotation, simply choose it from the Marker Shape dropdown when creating or editing an annotation. All of your custom markers will be organized under the Custom marker group.
Custom Markers are visible anywhere the annotation is visible: On your own 360s, on share/embed links, as well as Shared 360s.
You can use Custom Markers on any type of Annotation or Hotspot; you can also go back and edit existing annotations to use custom markers; all links and embeds displaying this annotation will display the updated marker immediately.
In Plan Drawings
To use a Custom Marker in Plan Drawings, simply choose it from the Marker Shape dropdown when creating or editing a Marker Placement.
While you the Add/Edit Custom Markers command is not available from the Plan Viewer, all the Custom Markers in your account will be visible in the dropdown.
Note: The interaction states for Custom Markers are the same in Annotations and Plan Drawings; markers are sized slightly smaller when used in Plan Drawings.
Custom Markers and Shared 360s
Any Custom Annotation Markers you create become available on your 360s to anyone you have authorized to annotate a shared 360; e.g. any users with annotation permissions will see the additional custom marker options when they go to choose an annotation marker. (For more information on permissions, see the Sharing: Permissions Overview)
Note that this only applies to your 360s; recipients of your 360s cannot use your custom markers on their own 360s.
If you are the recipient of a Shared 360, you are currently only limited to the markers in the Basic set and the 360 owner's Custom marker set; you are not able to use your own Custom Markers on a 360 owned by someone else.
What happens to annotations that have a custom marker if you delete that marker?
All existing annotations with that marker fall back to the default annotation marker (Square).
Why do my icons look stretched and wrong?
The icon images need to be in a 1:1 aspect ratio (e.g. 512 x512). If they aren't, they will get stretched when rendered as an annotation marker. One way to avoid this is to fill in any blank space with transparent pixels.
What image formats can you use for marker images?
Most image formats (jpg, png, gif) are accepted, but we strongly encourage using PNGs. We also accept SVGs but because of the way they are converted into textures when rendered they may not display in the proper aspect ratio (we are planning to remedy this in the future).
One option for converting SVGs into PNGs is to upload them but use the "Crop" tool in the uploader to set the aspect ratio to 1:1; your mileage my vary.
What happens to my custom markers if I downgrade from the Pro account?
All existing annotations with custom markers will remain as they are, however you won't be able to use/access the Custom Markers until you resume your Professional subscription. Your markers will remain intact in the meantime, however (we won't delete them).
What happens if I share a 360 with someone else?
If that user has the ability to annotate, they will be able to view and use any of your annotation markers on their annotations. To restrict the ability to annotate, see permissions.
Where can I find some icons?
For general-purpose icons we recommend looking at Font Awesome (https://fontawesome.com/); they have a wide range of icons, some for free, and there are sites that will convert them to PNG format.
Have any other questions? Contact firstname.lastname@example.org and we'll answer them!