🚨 Slack Error: 'too_many_emoji' — Cause, Fix, and Troubleshooting Guide

Overview

too_many_emoji is returned by reactions.add when a message has reached the limit for the number of distinct reaction emoji it can carry (across all users). Once that many different emoji are present, no new distinct emoji can be added.

{
    "ok": false,
    "error": "too_many_emoji"
}

Symptoms

• A popular message with lots of varied reactions rejects a new, different emoji.
• Adding an emoji that’s already on the message (joining an existing reaction) still works.
• Only appears on heavily-reacted messages.

Common Root Causes

1. The message already has the maximum distinct emoji

Busy channels accumulate many different reactions; your bot’s new, unique emoji tips it over the distinct-emoji ceiling.

2. Bot introduces novel emoji per event

An automation that maps each event type to a brand-new emoji keeps adding distinct reactions.

3. Custom-emoji sprawl

Lots of custom emoji reactions on one message use up the distinct slots.

How to diagnose

Count distinct emoji on the message:

curl -s "https://slack.com/api/reactions.get?channel=C0123456789&timestamp=1700000000.000100" \
  -H "Authorization: Bearer $SLACK_BOT_TOKEN" \
  | python3 -c 'import json,sys; m=json.load(sys.stdin)["message"]; print("distinct:", len(m.get("reactions",[])))'

distinct: 23

A high distinct count with a rejected new emoji confirms the cap.

Fixes

• Reuse existing emoji where possible — joining an existing reaction never trips the distinct limit.
• Standardise a small emoji vocabulary for your bot so it doesn’t introduce novel emoji per event.
• Move rich signalling off reactions and into a threaded reply or Block Kit status block when a message is already reaction-heavy.

What to watch out for

• too_many_emoji is about distinct emoji on the message; too_many_reactions is about how many a single user has added.
• You can still add to an emoji that’s already present — only genuinely new emoji are blocked.
• If reactions are load-bearing for your automation, don’t depend on adding a unique emoji to a message you don’t control; it may already be full.

Related

• Slack Error: ‘too_many_attachments’
• Slack Error: ‘ratelimited’
• Reaction-driven Slack automations for ops