Skip to content

deadboy18/keytag-label-maker

Repository files navigation

🏷️ Keytag Label Maker

A free, browser-based tool to create print-ready paper inserts for plastic key identification tags. Type your labels, print at 100% scale, cut along the guides, and slide them in.

πŸ”— Try it live β†’


πŸ”‘ What are these key tags?

These are the colored plastic key tags (also called key fobs, key ID tags, or key labels) commonly used by hotels, offices, building management, and facility teams to organize and identify keys.

Key tags in different colors
Available in many colors β€” red, blue, green, yellow, black, etc.
Key tag on a key
Each tag has a transparent window to slide in a paper label

The Problem

Writing labels by hand is messy and inconsistent. Ordering custom printed inserts is slow and expensive for small batches. This tool lets you type and print professional labels in seconds.

Before (handwritten) After (printed)
Handwritten label Printed label

✨ Features

  • πŸ”€ Auto-fit text β€” Font size dynamically shrinks to fit the label box
  • πŸ”  Font & formatting β€” Choose font family, bold, italic, underline, and text alignment
  • πŸ“„ A4 print-ready β€” Designed for A4 paper at 100% scale
  • πŸ“ Multiple tag sizes β€” Standard, small, and large presets + custom dimensions
  • πŸ“‹ Bulk input β€” Paste a list to create many labels at once
  • βœ‚οΈ Cut guides β€” Dashed borders for easy cutting
  • πŸ“¦ Zero dependencies β€” Single HTML file, no install needed
  • 🌐 Works offline β€” Download and open in any browser
  • πŸ†“ Free & open source β€” MIT licensed

πŸ“ Key Tag Sizing Reference

Measure your own tags first! Sizes vary between manufacturers. The dimensions below are based on the most common tags available on Amazon / Shopee / AliExpress.

Standard Tag (Most Common)

Standard tag dimensions

        β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
        β”‚  β—‹                                  β”‚
        β”‚  β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”  β”‚
        β”‚  β”‚                               β”‚  β”‚ 1.4 cm
  5.0cm β”‚  β”‚      YOUR LABEL HERE          β”‚  β”‚ (visible window height)
        β”‚  β”‚                               β”‚  β”‚
        β”‚  β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜  β”‚
        β”‚           2.8 cm (window)    β—‹      β”‚
        β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
                      2.2 cm (body width)

  Paper insert size: 4.3 cm Γ— 1.8 cm  ← this is what you cut & slide in
Measurement Value
Tag body (overall) 5.0 Γ— 2.2 cm
Visible window 2.8 Γ— 1.4 cm
Paper insert (cut size) 4.3 Γ— 1.8 cm
Key ring hole βˆ… 6–7 mm
Split ring diameter βˆ… 1.7 cm
Material PP or PE plastic

Other Common Sizes

Tag Type Tag Body Window Paper Insert
Small 4.8 Γ— 2.2 cm 2.9 Γ— 1.4 cm 3.0 Γ— 1.9 cm
Standard 5.0 Γ— 2.2 cm 2.8 Γ— 1.4 cm 4.3 Γ— 1.8 cm
Large 6.4 Γ— 2.8 cm 3.6 Γ— 1.8 cm 5.0 Γ— 2.2 cm

How to Measure Your Tags

If your tags don't match these sizes, measure the paper insert that came inside the tag:

Measuring key tag insert with ruler

  1. Remove the existing paper from inside the tag
  2. Measure the width (longer side) in cm
  3. Measure the height (shorter side) in cm
  4. Enter these as a custom size in the app

πŸ–¨οΈ How to Use

Step 1: Type Your Labels

Open the live app and click on any box to type. Text auto-sizes to fit.

Formatting options:

  • Pick a font from the dropdown (Arial, Helvetica, Verdana, etc.)
  • Toggle Bold, Italic, or Underline
  • Set a manual font size or use AUTO-FIT
  • Change text alignment (left, center, right)

Use Bulk Input to paste many labels at once:

GM ROOM
SERVER ROOM / L1-3
MEETING ROOM | B-13
CANTEEN (1)
FIRE PANEL

Use / or | to add a second line within a label.

Step 2: Print

  1. Click πŸ–¨οΈ Print / PDF
  2. Set paper size to A4
  3. ⚠️ Set scale to 100% (do NOT use "Fit to page")
  4. Set margins to Minimum or None
  5. Print directly or Save as PDF

Step 3: Cut & Insert

  1. Cut along the dashed lines
  2. Slide the paper strip into the tag slot
  3. The transparent film holds it in place

Screenshot of app


πŸš€ Deploy Your Own

GitHub Pages (easiest)

  1. Fork this repository
  2. Go to Settings β†’ Pages
  3. Set source to Deploy from a branch β†’ main β†’ / (root)
  4. Your site will be live at https://yourusername.github.io/keytag-label-maker/

Run Locally

No build tools needed. Just open the file:

git clone https://github.com/deadboy18/keytag-label-maker.git
cd keytag-label-maker
open index.html        # macOS
xdg-open index.html    # Linux
start index.html       # Windows

πŸ“ Project Structure

keytag-label-maker/
β”œβ”€β”€ index.html          ← The entire app (single file, no build step)
β”œβ”€β”€ README.md           ← You're reading this
β”œβ”€β”€ LICENSE             ← MIT license
└── images/             ← Reference photos

πŸ’‘ Use Cases

  • 🏨 Hotels β€” Room keys, storage rooms, service areas
  • 🏒 Offices β€” Server rooms, meeting rooms, utility closets
  • πŸ—οΈ Building Management β€” Pump rooms, fire panels, electrical rooms
  • 🏠 Home β€” Spare keys, garage, shed, mailbox
  • 🏫 Schools β€” Classrooms, labs, equipment storage

🀝 Contributing

Contributions are welcome! Some ideas:

  • Save/load label sets to browser storage
  • Additional tag size presets from different manufacturers
  • QR code or barcode support
  • Color-coded label backgrounds
  • Multi-page support for large batches
  • CSV import/export
  • Multi-language UI

πŸ“„ License

MIT License β€” free for personal and commercial use. See LICENSE.


Made for building engineers, facility managers, and anyone who manages keys πŸ”‘
If this saved you time, give it a ⭐

About

Free browser-based tool to create print-ready paper inserts for plastic key tags. Type, format, print at 100% scale, cut & slide. A4 pagination, auto-fit text, bulk input. Single HTML file, no install needed.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Contributors

Languages