Skip to main content

Creating Tags

Tags are the core of tagd-ai. Each tag is a container for content that's accessible via a unique QR code. This guide covers all the ways to create tags.

Creating a New Tag​

From the Dashboard​

  1. Click the + New Tag button in the top right corner
  2. A new untitled tag opens in the editor
  3. Add a title and start adding content
  4. Your tag is automatically saved

From Folders​

  1. Navigate to a folder in the sidebar
  2. Click + New Tag within that folder
  3. The tag is automatically organized in that folder

Using Keyboard Shortcuts​

  • Press N from the dashboard to create a new tag
  • Press Ctrl/Cmd + N from anywhere

Claiming Existing Tags​

If you have a physical tagd-ai product (like a pre-printed QR code):

  1. Scan the QR code with your phone
  2. If the tag is unclaimed, you'll see a "Claim this Tag" button
  3. Sign in to your tagd-ai account
  4. Click Claim Tag to take ownership
  5. The tag is now yours to edit
Claim Limits

Free accounts can claim up to 5 tags. Upgrade to Pro for unlimited claims.

Creating Tags via API​

For programmatic tag creation:

curl -X POST https://api.tagd-ai.com/v1/tags \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "My API Tag",
    "content": [
      {
        "type": "text",
        "content": "Created via API"
      }
    ]
  }'

See the API Reference for complete documentation.

Tag Properties​

Every tag has these properties:

PropertyDescription
TitleThe name of your tag (visible to viewers)
Short IDUnique 6-character identifier (auto-generated)
ContentBlocks of content (text, images, files, etc.)
PermissionsWho can read and write
CreatedTimestamp of creation
UpdatedTimestamp of last edit
OwnerThe user who owns the tag

Duplicating Tags​

Create a copy of an existing tag:

  1. Open the tag you want to duplicate
  2. Click the ⋮ menu in the toolbar
  3. Select Duplicate
  4. A new tag opens with copied content
  5. The duplicate gets a new Short ID
Template Tags

Use duplicating to create template tags. Create one tag with your standard format, then duplicate it for new items.

Importing Content​

From Other Platforms​

Currently, direct import from other platforms isn't supported. You can:

  1. Copy/paste text content directly
  2. Upload files from your device
  3. Use the API for automated imports

From Files​

  • Drag and drop files directly into the editor
  • Supported: images, PDFs, documents, and more

Best Practices​

Naming Conventions​

  • Use descriptive, searchable titles
  • Include identifiers if tracking assets (e.g., "Laptop - SN12345")
  • Keep titles under 60 characters for best display

Organization from the Start​

  • Create folders before creating many tags
  • Use hashtags in content for filtering
  • Pin important tags for quick access

Content Planning​

  • Plan your content structure before creating
  • Use consistent formatting across related tags
  • Consider mobile viewers (most scans are on phones)

Next Steps​