> For the complete documentation index, see [llms.txt](https://docs.scribeware.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.scribeware.com/customizations/smart-tags.md).

# Smart Tags

Structured, reusable data you attach to observations and photos — locations, recommendations, contractors, costs — that prints the way you designed it and rolls up into tables, filters and summaries.

Most of what you write in a report is prose. Smart tags are the part that isn't: the same handful of facts, recorded the same way every time, so they can be printed consistently, counted, tabulated, filtered and searched.

A photo of a leaking trap might carry *Area: Kitchen*, *Specific: under sink* and *Recommendation: Repair*. You pick those from lists instead of typing them, they print in the layout you designed once, and they turn into a summary table without you doing anything else.

{% hint style="info" %}
Smart tags are **not** the same as [Observation Tags](https://docs.scribeware.com/customizations/observation-tags.md) or [Photo Tags](https://docs.scribeware.com/customizations/photo-tags.md). Those are single words you stick on an item to filter and sort by. A smart tag carries a **name and a value** — it's a field, not a label — and it prints in the report.
{% endhint %}

{% hint style="warning" %}
**Anything marked (beta) needs the 7.2 compatibility update.** Those features stay off for your whole company until it's updated, and the update can't be undone. See [Updating Company Compatibility](https://docs.scribeware.com/customizations/updating-company-compatibility.md).
{% endhint %}

## The Three Pieces

| Piece               | What it is                                     | Example                              |
| ------------------- | ---------------------------------------------- | ------------------------------------ |
| **Smart tag group** | A set of related tags that get added together  | "Recommendations"                    |
| **Smart tag**       | One named row inside the group                 | "Action", "Contractor", "Urgency"    |
| **Detail**          | The value on that row — a tag can hold several | "Repair", "licensed plumber", "soon" |

Add the group to an observation and you get an **instance** of it — one filled-in copy.

## Two Kinds of Group (beta)

| Kind                    | What it's for                                                                                            | Where it lives                                                                                                                                                                          |
| ----------------------- | -------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Location**            | *Where* something is, in as many **levels** as you need — one free-text box, or *Unit / Area / Specific* | On **photos and tag cards** only                                                                                                                                                        |
| **Tag group** (generic) | Everything else — observations, recommendations, contractors, costs, data like an HVAC unit              | Where the group says: on **photos and tag cards** (a *photo group*, like observations), or on the **comment** (a *comment group*), whose photo tags, when allowed, merge into its block |

Location is its own kind because it behaves differently from everything else: it belongs to a photo, it fills itself in from where the photo is placed, and it's what the report is organized by when you inspect room by room. See [Location Groups](https://docs.scribeware.com/customizations/smart-tags/location-groups.md).

## What You Can Build On Top

| Feature                                                                                                                                                | What it gives you                                                                                                                                                     |
| ------------------------------------------------------------------------------------------------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [**Location groups**](https://docs.scribeware.com/customizations/smart-tags/location-groups.md) (beta)                                                 | Levels with preset lists, location pins on chapters, sections and observations, and room-bucket comments that stamp a room onto every photo added to them             |
| [**Categories and boxes**](https://docs.scribeware.com/customizations/smart-tags/categories-and-boxes.md) (beta)                                       | Any tag's presets organized into boxes and headings — an Observations tag per chapter, opening on the section's box, with the last observations you used one tap away |
| [**Photos and tag cards**](https://docs.scribeware.com/customizations/smart-tags/smart-tags-on-photos.md) (beta)                                       | Tags that belong to one photo — or to a *tag card*, a box with tags and no photo — rolled up into the observation                                                     |
| [**Photo Tag Bullets, the caption and the location line**](https://docs.scribeware.com/customizations/smart-tags/photo-tag-list-and-caption.md) (beta) | Every photo's tags printed together — *"Kitchen – under sink — Repair"* — the caption under every photo, and how a location reads as one line                         |
| [**Layouts**](https://docs.scribeware.com/customizations/smart-tags/how-smart-tags-print.md) (beta)                                                    | A standard layout for a group's own block, and custom block layouts for the rest                                                                                      |
| [**Detail labels**](https://docs.scribeware.com/customizations/smart-tags/detail-labels.md) (beta)                                                     | One option, two wordings — *Water damage* on the button, the full sentence in the report                                                                              |
| [**Calculated tags**](https://docs.scribeware.com/customizations/smart-tags/calculated-smart-tags.md) (beta)                                           | A value worked out from other tags and from the observation — *Location defaults to the chapter name*                                                                 |
| [**Finding photos**](https://docs.scribeware.com/customizations/smart-tags/finding-the-right-photos.md) (beta)                                         | Narrow the gallery to what an observation or a room is looking for, and pull those photos in                                                                          |
| [**Section defaults**](https://docs.scribeware.com/customizations/smart-tags/section-defaults.md)                                                      | *In a "Unit 3" section, the unit is Unit 3* — groups and values that new observations and photos arrive with                                                          |
| [**Tables**](https://docs.scribeware.com/customizations/tables.md)                                                                                     | An observations table with a Location column, one row per photo or per observation, filtered to the rows you want                                                     |
| [**Smart Summaries**](https://docs.scribeware.com/customizations/smart-summaries.md) (beta)                                                            | Extra summaries built from a tag group, like every observation a plumber needs to look at, in the report summary or on their own page                                 |

## Where Everything Lives

* **Settings → Smart Tags** is where groups are built and attached. The dropdown at the top — *Edit Smart Tag Groups For:* — switches between **All Smart Tags**, **This Report** and **This Template**. In a report or template it also shows which location group that report uses, and the **Photo Tag Bullets, caption and location line** layouts.
* **On an observation**, the tag-shaped **Smart Tags** button in the observation toolbar (desktop) or the **Smart Tags** button beside *Add Tag* (mobile) opens the tagging panel. The cards beneath the observation show what's already on it, including a preview of Photo Tag Bullets.
* **On a photo (beta)**, **+ Add Smart Tag** on the edit-photo screen (desktop) or **Smart Tag** in the photo footer (mobile) tags the photo itself.
* **In a section's settings**, the **Tag Defaults** button sets what new observations and photos there start with — including the section's location.
* **In the gallery (beta)**, the **Photo Tags** button filters by smart tags.
* **In Settings → Report Templates (beta)**, the **Smart Summaries** button sets up [Smart Summaries](https://docs.scribeware.com/customizations/smart-summaries.md).

{% hint style="warning" %}
Smart tag groups are stored **globally for your company**, not per template. Editing a group changes it everywhere it's attached. What each *report* can override is how a group **prints** — see [How Smart Tags Print](https://docs.scribeware.com/customizations/smart-tags/how-smart-tags-print.md). A location group has no per-report settings at all.
{% endhint %}

## What They're Good For

* **Consistency.** Every inspector on the team records location the same way, because they're picking from the same list.
* **Speed.** Tapping three chips beats typing three phrases, and the values you use most — and the one you used last — are the first thing offered. A long clause gets a detail label on its chip, so the buttons stay readable without shortening what prints.
* **Tables.** Anything recorded as a smart tag can become a column in a summary table: a whole-house list of every deficiency and where it was found, built from the tagging you were doing anyway.
* **Routing photos.** Tag a photo with its room once, and the observation for that room can find it — or place photos in a room's comment and they're tagged with the room automatically.
* **Completeness.** Mark a tag *Detail Required* and any observation missing it gets flagged for review before you publish.

## Where to Next

{% content-ref url="/pages/H6gUlYu82H6voVskq8Xl" %}
[Updating Company Compatibility](https://docs.scribeware.com/customizations/updating-company-compatibility.md)
{% endcontent-ref %}

{% content-ref url="/pages/mvmhDnPX8KHfPfgHb4ZF" %}
[Building a Smart Tag Group](https://docs.scribeware.com/customizations/smart-tags/building-a-smart-tag-group.md)
{% endcontent-ref %}

{% content-ref url="/pages/E7XXUpvacKsrIcqviqYP" %}
[Tagging as You Inspect](https://docs.scribeware.com/customizations/smart-tags/tagging-as-you-inspect.md)
{% endcontent-ref %}

{% content-ref url="/pages/UEvugnfyIcO7vEtZz4PR" %}
[Location Groups (beta)](https://docs.scribeware.com/customizations/smart-tags/location-groups.md)
{% endcontent-ref %}

{% content-ref url="/pages/GMmnUF2DwdmorE34LKie" %}
[Section Defaults](https://docs.scribeware.com/customizations/smart-tags/section-defaults.md)
{% endcontent-ref %}

{% content-ref url="/pages/ZQbZnW5YqIzeVeTIUBzT" %}
[Smart Tags on Photos (beta)](https://docs.scribeware.com/customizations/smart-tags/smart-tags-on-photos.md)
{% endcontent-ref %}

{% content-ref url="/pages/wKd3fRxTEpcDAYq4Sze1" %}
[Finding the Right Photos (beta)](https://docs.scribeware.com/customizations/smart-tags/finding-the-right-photos.md)
{% endcontent-ref %}

{% content-ref url="/pages/exQiifICVNWO1470Gcbt" %}
[Photo Tag Bullets, the Caption and the Location Line (beta)](https://docs.scribeware.com/customizations/smart-tags/photo-tag-list-and-caption.md)
{% endcontent-ref %}

{% content-ref url="/pages/6a8H2ovyMivwcgi9XB15" %}
[How Smart Tags Print (beta)](https://docs.scribeware.com/customizations/smart-tags/how-smart-tags-print.md)
{% endcontent-ref %}

{% content-ref url="/pages/JHRproTIhAZsA54jiBwx" %}
[Detail Labels (beta)](https://docs.scribeware.com/customizations/smart-tags/detail-labels.md)
{% endcontent-ref %}

{% content-ref url="/pages/sF71yx6eUjpdzxwjEvPN" %}
[Calculated Smart Tags (beta)](https://docs.scribeware.com/customizations/smart-tags/calculated-smart-tags.md)
{% endcontent-ref %}

{% content-ref url="/pages/JEPOBd0DzrSCXHA7harb" %}
[Common Workflows (beta)](https://docs.scribeware.com/customizations/smart-tags/common-workflows.md)
{% endcontent-ref %}

## Built From Smart Tags

Two features have their own sections and read from your smart tags.

{% content-ref url="/pages/S0IdErRuBYx78xTZLqi0" %}
[Smart Summaries (beta)](https://docs.scribeware.com/customizations/smart-summaries.md)
{% endcontent-ref %}

{% content-ref url="/pages/dbnpk7P7uPbmZS5TNGTC" %}
[Tables](https://docs.scribeware.com/customizations/tables.md)
{% endcontent-ref %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.scribeware.com/customizations/smart-tags.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
