HandiRamp DAM

Tag Taxonomy Worksheet — Guide

The worksheet is the master list of every tag the AI knows about. This is where you add new tags, update descriptions, and retire old ones.

Hosted at handiramp.com Changes sync to the AI automatically Source of truth for all tag definitions
Open the Tag Worksheet →

What the Worksheet Is

The worksheet is a live spreadsheet in your browser. Every tag the AI uses to label photos is defined here — its prefix, its label, its description, and whether it's active. Changes sync to the AI automatically — no export or file transfer needed.

HandiProducts — Photo Tagger Product Tags

Define product taxonomy for the AI photo tagger. Tags here = what gets written into image XMP metadata.

How to use: Click any cell to edit inline. The Description column feeds directly into the AI prompt — write clearly to help the AI distinguish similar products. Toggle Active to retire a tag without deleting it. Click + Add tag to add new products. Changes are picked up automatically — the next time an image drops into intake, the tagger fetches the latest tags from the worksheet before processing.
hr: HandiRamp ps: PetStep ht: HandiTreads sc: Scene / Environment spec: Specifications
Company Full Tag Product Type Label Category → Sub Description (AI prompt text) Active
HandiRamp (hr:) hr:curb-ramp Curb Ramp Curb Ramp Accessibility & Mobility ADA-style aluminum or steel curb ramp at sidewalk or parking lot edge. Yellow painted. Active
PetStep (ps:) ps:pool-ramp Pool Ramp Pool Ramp Pet Mobility Ramp leading into a pool for pet entry/exit. Water visible in background. Active
Spec (spec:) spec:1500lb Capacity 1500 lb CVR Specifications → Capacity CVR with 1500 lb capacity. Human-assigned during review. Tri-fold CVRs are always spec:1500lb; bi-fold with visible folding legs are also 1500lb. Active
NEW hr:new-tag …fill in description…

Adding a New Tag

Use this when you have a product or scene type that the AI doesn't know about yet.

1

Click "+ Add tag" at the bottom of the table

A new blank row appears highlighted in yellow at the bottom of the list. Each column is editable.

2

Fill in every column

Full Tag — the machine-readable slug with prefix, e.g. hr:loading-dock-ramp. Lowercase, hyphens only, no spaces.

Label — the human-readable name shown in the review UI, e.g. "Loading Dock Ramp".

Description — the most important field. This text goes directly into the AI's prompt. Be precise and distinguish it from similar products. Example: "Heavy-duty steel ramp bridging a loading dock to a truck bed. Fixed angle, industrial setting."

Category — the broad grouping this tag belongs to.

3

Click "💾 Save"

This saves your edits to the worksheet page. The tagger will pick up the changes automatically before the next batch — within 5 minutes of a new image arriving in intake.

4

That's it — changes sync automatically

No export, no file transfer, no restart needed. When the next image drops into intake, the tagger checks if 5+ minutes have passed since its last sync — if yes, it fetches the latest worksheet before tagging that batch.

If you're editing ahead of a specific batch, make your changes first, then drop the images — the tagger will pick up your edits before processing begins.


Editing & Retiring Tags

You can update any tag at any time. Changes take effect on the next batch.

✏️ Editing a tag

Click directly on any cell in the table to edit it inline. The most impactful edits are to the Description column — better descriptions mean the AI makes fewer mistakes.

If the AI keeps confusing two products, refine both descriptions to spell out the visual difference explicitly.

🚫 Retiring a tag

Toggle the Active checkbox off to deactivate a tag. The AI will stop using it on new batches but the tag stays in the worksheet so you can reactivate it later.

Don't use "Remove" unless you're sure the tag should never come back — Active toggle is safer.

🔍 Filtering the table

Use the search box to find a tag by name, label, or description. Use the company and category dropdowns to filter to just HandiRamp, PetStep, etc. The "Active only" checkbox hides retired tags.

📋 Tag FAQ button

The Tag FAQ button at the top of the worksheet opens a quick reference panel covering common tagging questions and disambiguation rules — e.g. nosing vs. stair tread, pool context, spec tag rules.


Writing Good Descriptions

The Description column is the AI's instruction manual for each tag. The better your descriptions, the more accurately the AI tags photos without human correction.

Be visually specific

Describe what the reviewer would see in the photo, not what the product does. Instead of "Ramp for wheelchairs," write "Portable folding aluminum ramp with raised edge rails, used at doorways or curbs. Usually carried by one person."

Distinguish from similar products

If two tags look alike in photos, explicitly call out the difference. Example: "Nosing = L-shaped aluminum edge piece mounted at the front lip of a step only. NOT the same as a stair tread, which covers the full step surface."

Include context clues

Mention environmental signals that strongly indicate the tag. Example for ps:pool-ramp: "Water visible in background. Dog present. Ramp leading into pool. Never applied to stair contexts."


Important Rules

✓ Tag slugs are permanent Once a tag slug (e.g. hr:curb-ramp) is in the system and applied to photos, don't rename it. Rename the Label or update the Description instead. Changing a slug breaks existing tagged photos.
ℹ️ Tag prefixes are fixed The prefix determines which brand a tag belongs to: hr: HandiRamp · ps: PetStep · ht: HandiTreads · sc: Scene context · spec: Specifications. Don't mix prefixes across brands.