Platform Tips

Custom Shortcode Sets for Refs, Venues, and Action Calls

May 20, 2026
Back to Blog

Custom Shortcode Sets for Refs, Venues, and Action Calls

Saturday afternoon basketball, fourth quarter. Two fouls in the post, a flagrant called, the lead ref reviews the monitor. Photo Mechanic needs the official's name in the caption. You type the home center's shortcode and the player data fills in. Then you stop. The ref isn't in your roster file. Neither is the arena, the city, or the action call.

That's what SnapCaption's custom shortcode sets handle. Three reusable sets get saved to your account: referees, venues, and sport-specific action descriptions. Attach any of them to a TSV download. The roster file covers the players. The custom sets cover the rest.

Key Takeaways
  • ✓ Custom shortcode sets save the data the roster file doesn't carry: referees, venues, and action descriptions.
  • ✓ Three set types: officials by position, stadium and arena details, sport-specific play types.
  • ✓ Sets attach to any TSV download, so the work pays off across the whole season.
  • ✓ Football, basketball, hockey, and baseball each have their own action vocab worth saving separately.
  • ✓ Custom codes load into Photo Mechanic exactly like roster codes, using the same code replacement panel.

What Custom Shortcode Sets Cover (and What They Don't)

The roster file is the obvious one. Each row maps a jersey number to a player and gets refreshed when SnapCaption pulls the weekly league update. That handles the players on the court, the field, or the ice.

Custom shortcode sets handle the rest. Three set types live in your SnapCaption account:

Referees and officials by position. Head ref, umpire, line judge, side judge, and so on. The names rotate game to game but the shortcode structure stays put. Venues, including stadium and arena names, the city, and the locator detail many wire desks ask for. Wire stringers covering road games lean on this set hard because the venue changes for each assignment. Action descriptions, meaning sport-specific play types that show up in captions repeatedly. Touchdown, three-pointer, hat trick, walk-off home run. Each sport gets its own action vocab.

These sets attach to whatever TSV you download. Build them once, pick which ones to include during the SnapCaption export step, and they ride along with the roster data. The full workflow for loading the TSV into Photo Mechanic code replacement stays unchanged.

The roster file handles the players. Custom shortcode sets handle everything else that ends up in a caption.

Building a Reusable Referee Code Set

Start with the official positions you actually caption. Football has head referee, umpire, head linesman, line judge, side judge, back judge, and field judge. Basketball has crew chief, referee, and umpire. Hockey, baseball, and the soccer leagues each have their own short list of officials worth saving.

Pick a prefix that won't collide with your roster shortcodes. If your players use h and v for home and away, refs can use r and a position number. Head ref becomes r1, umpire r2, line judge r3, and so on. Consistent structure beats clever naming.

For pro leagues, official assignments are published before the game and the names are publicly available. For NCAA Division 1 work, conferences publish their officiating crews, and sports information directors usually have the night-of confirmation. Update the names inside your ref set when assignments land. The shortcode structure stays the same. Only the data behind each code changes. The set lives in your SnapCaption account between sessions, and the prefix-plus-number naming follows the same pattern covered in the Photo Mechanic shortcodes setup guide.

Refs rotate game to game. The shortcode set stays. Update names, keep the structure.

Venue and Action Sets That Pay Off Across the Season

Venue sets earn their keep on the road. For pro photographers and wire stringers covering away games week after week, the win is straight typing speed. Arena name, city, sometimes the cross-street or capacity figure for the wire desk's locator format. Build one entry per venue you cover and the lookup never happens again.

Action sets are where the sport-specific work shows up. Football needs touchdown, interception, fumble recovery, sack, two-point conversion. Basketball needs dunk, three-pointer, blocked shot, alley-oop, technical foul. Hockey needs goal, save, hat trick, power-play goal, penalty kill. Baseball needs home run, strikeout, double play, walk-off, no-hitter. Soccer needs the goal, the save, the through ball, the corner kick.

Each sport gets its own action set in your SnapCaption account. The codes don't carry over because the play types don't. A football action set loaded into a basketball file would map a touchdown code to a basketball caption, which is the kind of bug that costs you a correction request at deadline. The same account-level persistence that keeps your shortcode set in place when you handle mid-season roster changes applies to action sets too.

Build the Custom Code Sets Once. Use Them All Season.

SnapCaption saves referee, venue, and action code sets to your account. Attach them to any TSV you download.

Set It Up Once Before Your Next Game

The 30 minutes you spend setting up custom code sets at the start of the season returns hundreds of saved keystrokes by playoffs. Refs, venues, and action calls show up in pro and wire captions and D1 sports information releases. When those expand from shortcodes too, the captioning stops feeling like data entry.

The roster file gets the players. The custom sets get the rest.

Build the file once. Reuse it all season.

Frequently Asked Questions

What's the difference between roster shortcodes and custom shortcode sets?

Roster shortcodes map jersey numbers to player data and are refreshed weekly from official league sources. Custom shortcode sets are your own additions for officials, venues, and action descriptions. Both live in the same TSV and load into Photo Mechanic the same way.

Do I have to rebuild custom code sets for each download?

No. Sets are saved to your SnapCaption account, not the individual TSV. Build a set once, then attach it to any download you generate across the season.

Can I have different action sets for different sports?

Yes, and you should. Football, basketball, hockey, baseball, and the soccer leagues each have their own play vocabulary. Keep separate action sets per sport so the right codes load when you cover that league.

How are referee names handled if officials rotate between games?

Update the names inside your ref set when assignments are announced. The shortcode structure stays the same, only the data behind it changes. Pro league officials are published before each game; D1 conferences publish their officiating crews on the same cadence.

Do custom codes work in Photo Mechanic the same way roster codes do?

Yes. The TSV format is uniform across player rosters and custom code sets. Photo Mechanic's code replacement panel reads both kinds of entries identically. The Use Code Replacements toggle still needs to be on for either to expand.

What SnapCaption Does

SnapCaption is a roster file generator for sports photographers. It creates TSV files compatible with Photo Mechanic, GalleryID Desktop, Adobe Bridge, and Capture One.