Reference Tag Organizer

Clean up and apply tags across a reference board.

Pageboard project JSON

{
  "format": "pageboard-project",
  "version": 1,
  "name": "A small collection",
  "entries": [
    {
      "id": "studio",
      "title": "A quiet studio",
      "url": "",
      "type": "Portfolio",
      "platform": "Desktop",
      "tags": [
        "Editorial",
        "Typography"
      ],
      "notes": "Try a generous margin and a single strong headline.",
      "favorite": true,
      "accent": "#d9b99f",
      "screenshot": ""
    },
    {
      "id": "garden",
      "title": "The garden journal",
      "url": "",
      "type": "Editorial",
      "platform": "Mobile",
      "tags": [
        "Nature",
        "Photography"
      ],
      "notes": "Look for a calm rhythm between image and text.",
      "favorite": false,
      "accent": "#a9b99d",
      "screenshot": ""
    },
    {
      "id": "objects",
      "title": "Objects for everyday",
      "url": "",
      "type": "Shop",
      "platform": "Desktop",
      "tags": [
        "Minimal",
        "Product"
      ],
      "notes": "A restrained palette lets the objects stand out.",
      "favorite": false,
      "accent": "#bfc3d2",
      "screenshot": ""
    },
    {
      "id": "festival",
      "title": "An independent festival",
      "url": "",
      "type": "Event",
      "platform": "Mobile",
      "tags": [
        "Color",
        "Typography"
      ],
      "notes": "Explore expressive type and a clear schedule.",
      "favorite": false,
      "accent": "#e2b878",
      "screenshot": ""
    }
  ],
  "moodboard": {
    "items": [
      {
        "id": "m-studio",
        "kind": "reference",
        "x": 60,
        "y": 60,
        "w": 260,
        "h": 220,
        "text": "",
        "color": "#d9b99f",
        "ref": "studio",
        "image": ""
      },
      {
        "id": "m-garden",
        "kind": "reference",
        "x": 360,
        "y": 60,
        "w": 220,
        "h": 220,
        "text": "",
        "color": "#a9b99d",
        "ref": "garden",
        "image": ""
      },
      {
        "id": "m-note",
        "kind": "note",
        "x": 620,
        "y": 60,
        "w": 240,
        "h": 150,
        "text": "Calm, editorial, lots of white space.",
        "color": "#fff6d8",
        "ref": "",
        "image": ""
      },
      {
        "id": "m-sand",
        "kind": "swatch",
        "x": 620,
        "y": 240,
        "w": 120,
        "h": 110,
        "text": "Sand",
        "color": "#d9b99f",
        "ref": "",
        "image": ""
      },
      {
        "id": "m-moss",
        "kind": "swatch",
        "x": 760,
        "y": 240,
        "w": 120,
        "h": 110,
        "text": "Moss",
        "color": "#6f7f5f",
        "ref": "",
        "image": ""
      }
    ]
  }
}

Tag action

Tag to add or remove

☁ Sign in to save to your Google Drive

Try an example: Clean up messy tags · Add a research tag to every reference · Remove a tag in any letter case

More about this tool

How it works

Normalize tags on a Pageboard project, then optionally add or remove a tag on every reference. Download the updated editable board.

Trims and collapses whitespace in existing tags and removes empty tags. Tags that differ only in letter case are merged: the first spelling on the board (in reference order) is used everywhere, and duplicates on one reference are removed.
Add and remove apply to every reference after normalization. Adding a duplicate has no effect; removing compares without case. The entire operation is rejected if adding would exceed eight tags on any reference.
All other reference fields, links, notes, favorites and screenshots are preserved. No source pages are loaded.
The project download is the editable result; the editor link carries the same data and is omitted when it would exceed one million encoded characters.

Sources

URL Standard (parsing and serialization of source links) (WHATWG)
Pageboard project format (JSON Schema) (usefulweb.site)

Part of Pageboard

Pageboard Website inspiration boards

Collect website references, sort them with tags and arrange them on a moodboard.

Open Pageboard

How to use the Reference Tag Organizer

Merge inconsistent tags across a Pageboard project and add or remove one tag on every reference in one run.

What it is for

Tags make a reference board searchable – until they drift. After a few weeks one card says typography, another Typography , a third has Forms twice. Filters then split what belongs together. The Reference Tag Organizer cleans this up for a whole Pageboard project at once and can add or remove one tag on every reference.

It returns a new editable project; your input is not changed. Titles, links, notes, favorites, screenshots and the moodboard stay exactly as they were.

In Pageboard itself, Organize → Tag filtered references… adds or removes a tag on just the references that match your current filters. This tool is the board-wide version for files, scripts and AI agents.

Worked example

The first example is a small imported board, "Imported bookmarks", with three references and messy tags:

Pricing with three plans: Pricing , pricing, Conversion table
Footer with a sitemap: Navigation, navigation , Typography
Signup in one step: Forms, typography, Forms

With Normalize only, the tool answered "Updated tags on 3 references. The board has 3 references." The result:

Pricing with three plans: Pricing, Conversion table
Footer with a sitemap: Navigation, Typography
Signup in one step: Forms, Typography

Spaces were trimmed and collapsed, duplicates on one card removed, and typography on the signup card took the spelling Typography that appears first on the board. The report now counts five distinct tags, with Typography on two references.

The third example removes TYPOGRAPHY from the same board. Matching ignores letter case, so both cards lost the tag; 3 references changed (the pricing card only through normalization) and four distinct tags remained. The second example adds research to all four references of the starter board – 4 changed.

How to read the result

Changed counts references whose tag list differs from the input, including changes made by normalization.
Distinct tags is the number of different tags left on the board.
Download updated board and Open in Pageboard carry the cleaned project. Open it, check a few cards, and keep the old file until you are happy.

Tips and common mistakes

Run Normalize only first and look at the result before adding or removing anything.
Which spelling wins depends on order: the first spelling in reference order is used everywhere. Fix that one card in Pageboard first if you prefer another spelling.
Adding fails for the whole board if any reference already has eight tags – nothing is half-applied.
Enter exactly one tag; commas are not split into several tags.
When adding a tag that already exists in another spelling (Research vs research), the existing spelling is used.

FAQ

Can I change only some references?

Not with this tool; add and remove apply to every reference. In Pageboard, filter the board and use Organize → Tag filtered references….

Does normalization change the order of tags?

No. Tags keep their order; only duplicates and empty tags are removed.

Are screenshots or links checked?

They are validated as part of the project but never changed, and no website is loaded.

Guide last updated: October 31, 2026

For scripts and AI agents

JSON API: POST https://pageboardtagorganizer.usefulweb.app/api/v1/calculate (same calculation as this page)
Interface description: OpenAPI 3.1 · AI guide: llms.txt
MCP server (Streamable HTTP): https://pageboardtagorganizer.usefulweb.app/mcp · tool name pageboard_tag_organizer

Example request

curl -s -X POST https://pageboardtagorganizer.usefulweb.app/api/v1/calculate \
  -H 'content-type: application/json' \
  -d '{…see OpenAPI examples…}'

Feedback · ideas & bug reports welcome