> For the complete documentation index, see [llms.txt](https://docs.jmapcloud.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.jmapcloud.io/en/jmap-cloud-portal/user-guide-for-jmap-cloud-portal/configuring-project-data/configuring-a-layer/labels.md).

# Labels

Labels are texts associated with cartographic features. They allow information related to these features to be displayed directly on the map. For example, it is possible to display city names from a point layer representing urban centers.

The **Labels** section, accessible via the labels icon <img src="/files/JGGz5SA7JUHSGhJI05gf" alt="" data-size="line">, allows you to configure the content, style, and display of labels for a layer's features.

<figure><img src="/files/ElcELiqu1dzPkH34wAQu" alt=""><figcaption></figcaption></figure>

<table data-header-hidden><thead><tr><th width="49.62109375" align="center" valign="top">#</th><th valign="top">Description</th></tr></thead><tbody><tr><td align="center" valign="top">1</td><td valign="top">Check this box to display labels in JMap NG applications.</td></tr><tr><td align="center" valign="top">2</td><td valign="top"><strong>Font</strong><br>Click this button to select the label text style: font, font size, bold, italic, font color, outline, and outline color.</td></tr><tr><td align="center" valign="top">3</td><td valign="top">Text field for writing the label content. See the <a href="#label-content">Label Content</a> section for details.</td></tr><tr><td align="center" valign="top">4</td><td valign="top"><p><strong>Attributes</strong></p><p>Attributes available for labels. <br>These are the layer attributes you check in the <a href="/pages/ztLj22r1PMp2QwGM2EGI">Properties</a> section.</p></td></tr><tr><td align="center" valign="top">5</td><td valign="top"><p><strong>Functions</strong></p><p>Functions available for labels. The  <a href="#label-content">Label Content</a> section details these functions.</p></td></tr><tr><td align="center" valign="top">6</td><td valign="top"><p><strong>Zoom levels</strong></p><p>Zoom level range at which labels are displayed. Specify the range by dragging the indicators on the bar or entering the minimum and maximum zoom values.</p></td></tr><tr><td align="center" valign="top">7</td><td valign="top"><p><strong>Position</strong></p><p>Determine the label position relative to the feature. Click <img src="/files/B51AH8WmJZYOmR7KxSwx" alt="" data-size="line"> to select from the available positions. </p><p><strong>Allow overlapping</strong></p><p>Check this box to allow the layer's labels to overlap each other and overlap labels from other layers. This option may be useful to ensure that all labels in a layer are displayed.</p><p><strong>Follow line</strong></p><p>Line features only. </p><p>Check this box to make the label text follow the shape of curved lines. </p><p><strong>Spacing (pixels)</strong></p><p>Line features only.</p><p>Specify the spacing (in pixels) between repeated labels on the same line.</p></td></tr><tr><td align="center" valign="top">8</td><td valign="top">Set the pixel offset on both dimensions of the label position relative to the feature.</td></tr><tr><td align="center" valign="top">9</td><td valign="top"><p><strong>Frame</strong></p><p>Check the box to add a frame around the label text. </p><p>Select the background and border color of the frame.</p></td></tr><tr><td align="center" valign="top">10</td><td valign="top"><p><strong>Rotation</strong></p><p>If you check <strong>Rotation by attribute</strong>, select the numeric attribute whose values will be used as the rotation angle, and the direction of rotation. Only line features have this option. </p><p>If you check <strong>Follow map rotation</strong>, labels will follow the map rotation.</p></td></tr><tr><td align="center" valign="top">11</td><td valign="top"><p><strong>Proportional size</strong></p><p>By default, label text is displayed at the specified font size regardless of the zoom level.</p><p>Check this option to have the label text size adjusted proportionally to the map's zoom level. Drag the point on the bar to select the reference zoom level at which the text is displayed at the specified font size. </p><p>When the map zoom level changes, the text size is adjusted accordingly.</p></td></tr><tr><td align="center" valign="top">12</td><td valign="top">Click the language of your choice to enter the label content in the selected language.</td></tr></tbody></table>

## Label Content

Labeling is done by defining a text that constitutes the label content. This can span multiple lines and contain both:

* **Static text** (unchanged)
* **Dynamic functions** (variables), automatically replaced by their value when displayed.

**Available functions:**

<table data-header-hidden><thead><tr><th width="261.06640625" valign="top">Function</th><th valign="top">Description</th></tr></thead><tbody><tr><td valign="top"><code>ev(attrib)</code></td><td valign="top"><p>Replaced by the value of the corresponding attribute.</p><p><strong>Example:</strong> <code>ev(id)</code> displays the value of the entity's <em>id</em> attribute.</p></td></tr><tr><td valign="top"><code>ev(attrib, useValueDomain)</code></td><td valign="top"><p>When <code>true</code> is specified for <code>useValueDomain</code>, replaced by the value domain label for the value of attribute <em>attrib</em>. </p><p>When <code>false</code> (or omitted), replaced by the attribute value itself. </p><p><strong>Example:</strong> <code>ev(categorie, true)</code></p></td></tr><tr><td valign="top"><code>ifNull(attrib, value)</code></td><td valign="top"><p>Replaced by <em>value</em> only if the attribute <em>attrib</em> is null. If the attribute value is not null, nothing is displayed. </p><p><strong>Example:</strong> <code>ifNull(temp, N/A)</code> displays N/A if the value of attribute <em>temp</em> is null.</p></td></tr><tr><td valign="top"><code>ifNotNull(attrib, value)</code></td><td valign="top"><p>Replaced by <em>value</em> only if the attribute <em>attrib</em> is not null. If the attribute value is null, nothing is displayed. </p><p><strong>Example:</strong> <code>ifNotNull(land_value, $)</code> displays $ only if the value of <em>land_value</em> is not null.</p></td></tr></tbody></table>

**To configure label content:**

1. Enter the desired static text.
2. To add dynamic content, place the cursor at the desired location in the text field.
3. Click the desired function. It is automatically inserted into the text, and a menu opens to let you choose the attribute to use.
4. Select the attribute and, if necessary, specify a value.
5. Click <img src="/files/3j5ZnWV2rz6osBQgefsz" alt="" data-size="line"> to save the label content.
