Skip to main content

Label Properties

Labels are a special feature property that can display information about a geometric feature.

Holly Conrad Smith avatar
Written by Holly Conrad Smith
Updated over 2 months ago

Add text and images to geometries to annotate information about your designs.

Turn on a Label

Click the eyeball to turn on the label . If needed, click the carat to expand the section.

Once the label is toggled on, it's properties can be edited in the left bar.

Label Settings

  1. Turn label on/off

  2. Kind: Text, Outlined, or icon

  3. Content

  4. Text Color

  5. Size (in pixels)

  6. Background Color

  7. Stick: Stick or No stick.

  8. Adjust stick height.

  9. Anchor: Anchor bottom or middle

  10. Position: The location along a line

  11. World Space: Toggle on to scale with zoom

  12. On Top: display in front of other geometry regardless of base position

  13. Subtitle: Add a subtitle. Useful for adding text to Icon markers!

  14. Popup: Add a rich text pop up that shows on click

Kind

Select pain text, outline, or image.

The label kind determines the available properties and settings for the label.

Text

Special Settings:

  • Select text and background color

Outline

Special Settings:

  • Select outline shape

  • Select text, background, and border color

  • Select border size (in pixels)

Image

Special Settings:

  • Upload an image

Content

The label content is the text, properties, or image that is displayed.

For text and outline labels, you can type text into the content box, or select properties to display.

Properties Selector

Label content can also display dynamic property values, like areas, lengths, usages, and more!

To reference a property in the label content, click the Pencil icon.

  • Search for properties in the dropdown. Select one or many.

  • Edit the text in the "Template" box. Do not edit anything {{within the brackets}}

  • Click "save marker text" to apply.

The label text reflects the template text. Anything {{within brackets}} displays the current value of that property.

Icon/Image Upload

For the Image label, an image uploader is shown.

Click "Change" to change the image.

Attachment

Select an existing project attachment, or upload a new one.

File

Select an existing file, or upload a new one

Link

Paste a url to link to an image hosted elsewhere.

Size

Adjust the overall scale of the label with the slider, up/dn arrows, or by typing any value. Use decimal values to make text smaller than 1.0.

Text, Background, or Border Color

Click the colored dot to pick any color from the selector, or paste in a hex code.

(Border style is available for outline kind only)

Border Size

For "outline" kind only: Set the border size in pixels.

Stick

Stick enabled: Toggle on/off for stick visibility.

Change stick height upon adding a stick.

Stick disabled

Stick enabled

Anchor

Choose how the marker is positioned on the geometry.

Position

The position of the label, specifically along a line.

On Top

Toggle on to display label in front of other geometry regardless of base position.

On

Off

World Space

Toggle whether the scale of the label is related to the screen size or real-world size

Toggle off: markers stay the same size in pixels relative to the screen as you zoom in and out

Toggle on: scale with zoom - ie they stay the same size in meters, but pixel size becomes larger or smaller with zoom

Subtitle

(Not available on plain text kind)

Add a smaller scale line of text next to your marker.

Popup

Triggers a pop up when a marker is clicked. Can edit contents, upload and image, and adjust visuals.

1. Content - Click the pencil to open the rich text editor.

2. Padding - Adjust the space around the content

3. Border Color - Set a border stroke color

4. Border Width - Set border stroke width

5. Border Radius - Round the border corners

6. Background Color - Set background

Edit Popup Content

Click the pencil to open the rich text editor.

Change text size, embellishment, and alignment.

Upload images.

Add properties.

Save to apply.

Hide Labels

If you want to look at your project without the markers you have created, you can toggle the visibility by clicking Toggle label Visibility.

Advanced

Custom markers can also be made by using any HTML as the markerHTML property.

A simple example is Setting the scale property to 0.

<div data-scale="{{properties.scale}}" data-id="{{properties.id}}" class="Marker-Three {{ properties.scale ? 'Marker-Scaled' : '' }}" > Label for {{properties.id}} ({{properties['multi word prop']}} </div>

Inside double brackets, you can refer to any properties and use any functions within the expr-val language.

Did this answer your question?