# YouTube Tags Character Limit: 500, and How Commas Count

Published: 2026-11-02

**Key takeaways:** All tags on a YouTube video share 500 characters, per the YouTube Data API. Commas between tags count, and a tag with a space counts 2 extra for the quotes YouTube adds. There is no tag count limit. YouTube says tags play a minimal role in discovery; they help most with misspellings.

**Short answer:** all the tags on a YouTube video share **500 characters**. The YouTube Data API defines that limit and adds two counting rules: the commas between tags count, and a tag that contains a space counts as if it were wrapped in quotation marks, so `sourdough shaping` costs 19 characters, not 17. YouTube sets no limit on the number of tags and documents no limit per tag. And before you spend time filling all 500: YouTube Help says tags "play a minimal role" in discovery next to the title, thumbnail and description. Write those first with the free [YouTube title generator](/tools/youtube-title-generator) and [YouTube description generator](/tools/youtube-description-generator), then add a few tags for the spellings your title does not cover.

## YouTube tag rules in one table

| What | Rule | Source |
|---|---|---|
| Total length | 500 characters for all tags together | Data API, videos |
| Commas | The commas between tags count toward the 500 | Data API, videos |
| Tags with a space | Counted as if wrapped in quotes: 2 extra characters each | Data API, videos |
| Number of tags | No limit; only the 500-character budget | Data API, videos |
| Length of one tag | Not documented by YouTube | n/a |
| Role in discovery | Minimal; title, thumbnail and description matter more | YouTube Help, tags |
| When tags help | When the topic is commonly misspelled | YouTube Help, tags |
| Too many tags | Excessive tags in the description break the spam policies | YouTube Help, tags |
| Hashtags | A separate feature in the title or description; more than 60 and all are ignored | YouTube Help, hashtags |

The title has its own limit of 100 characters ([YouTube title character limit](/learn/youtube-title-character-limit)) and the description 5,000 bytes ([YouTube description character limit](/learn/youtube-description-character-limit)).

## How the 500 characters are counted

The Data API gives one example: the tag `Foo-Baz` counts as 7 characters, and `Foo Baz` counts as 9, because YouTube treats a tag with a space as `"Foo Baz"` and the quotation marks count. Add one character for each comma between two tags, and the budget for a list is:

```text
letters of every tag
+ 2 for every tag that contains a space
+ 1 for every comma (number of tags minus 1)
```

Here is a real list for a sourdough shaping video, counted that way:

| Tag | Letters | Space? | Counts as |
|---|---|---|---|
| `sourdough shaping` | 17 | yes | 19 |
| `sour dough` | 10 | yes | 12 |
| `boule` | 5 | no | 5 |
| `shaping a boule` | 15 | yes | 17 |
| `bread shaping` | 13 | yes | 15 |
| `banneton` | 8 | no | 8 |
| `sourdough for beginners` | 23 | yes | 25 |
| 6 commas | | | 6 |
| **Total** | | | **107** |

Seven tags use 107 of the 500. Pasted as `sourdough shaping, sour dough, ...` into a plain character counter such as the free [social media character counter](/tools/social-media-character-counter), the same list shows 103 (it counts the spaces after the commas and misses the quotes), so a plain counter is close but not exact. If a script or an AI agent writes your tags, count them the way YouTube does:

```python
def youtube_tag_budget(tags: list[str]) -> int:
    quotes = sum(2 for t in tags if " " in t)
    commas = max(len(tags) - 1, 0)
    return sum(len(t) for t in tags) + quotes + commas

tags = ["sourdough shaping", "sour dough", "boule", "shaping a boule",
        "bread shaping", "banneton", "sourdough for beginners"]
print(youtube_tag_budget(tags))  # 107
```

Keep the result under 500. The API refuses a list it cannot accept with the error `invalidTags` ("The request metadata specifies invalid video keywords"), and, per Google's `videos.insert` code sample, an empty string as tags gets a `400 Bad Request`.

## Do YouTube tags still matter?

Not much, by YouTube's own account. Its Help page on tags says the title, thumbnail and description "are more important pieces of metadata for your video's discovery" and that tags otherwise "play a minimal role". The one case it names where they help is a topic that people often misspell.

That changes how to use the 500 characters:

- **Spend your keyword effort on the title and description.** YouTube's description tips say to pick one or two main words and use them in both. A tag cannot make up for a title that does not say what the video is.
- **Use tags for the spellings the title leaves out.** In the list above, `sour dough` covers people who type it as two words, and `banneton` names the basket that viewers may search for by name. The title already says "sourdough shaping", so the tag of the same phrase adds little.
- **Stop well before 500.** No rule says to fill the field, and a long list of loosely related words is what the spam policies are about. A handful of accurate tags is enough.

## Tags vs hashtags vs keywords in the description

The three are often mixed up, and they follow different rules:

| | Where it goes | What it does | Limit |
|---|---|---|---|
| Tags | The tags field in YouTube Studio | Descriptive keywords that help viewers find the video; a minimal role in discovery | 500 characters for all tags |
| Hashtags | In the title or description, with `#` and no spaces | Link to a hashtag results page; up to 3 show by the title | More than 60 on a video and all are ignored |
| Keywords | The words of the title and description | The main way viewers and search find the video | Title 100 characters, description 5,000 bytes |

YouTube Help warns against both kinds of excess: excessive tags in a description break the spam policies, and hashtags that are unrelated to the video can get it removed. A row of comma-separated keywords pasted at the end of a description is not a substitute for the Tags field.

## How to add tags in YouTube Studio

From YouTube Help:

1. **On a new upload:** in [YouTube Studio](https://studio.youtube.com), select **Create** → **Upload video** and pick the file. In the **Details** step, select **More options** and add your tags.
2. **On a video that is already up:** in YouTube Studio, open **Content**, select the video, then **Show more** and add your tags.

You can also edit tags in the YouTube app on your phone.

### Adding tags through the YouTube Data API

Tags are `snippet.tags`, a list of strings, on `videos.insert` and `videos.update`. Two things catch scripts out when they add tags to a video that is already uploaded:

- `videos.update` replaces the whole snippet. A property you leave out is deleted, so send the current `title`, `description` and `tags` together. `snippet.title` and `snippet.categoryId` are required whenever you update the snippet.
- An update costs 50 quota units; an upload counts against YouTube's separate Video Uploads quota.

## How PostBoost handles YouTube tags

PostBoost uploads a YouTube video with its title, the description (your post text), the privacy setting, the **Made for kids** flag and the AI-content disclosure (whether the video contains altered or synthetic media). **It does not send tags.** YouTube options have no tags setting, in the app or in `options.youtube` in the API and on the MCP server. The post-level `tags` field you may see in the API is for PostBoost's own workspace tags, which organise posts in your calendar; it is not sent to YouTube. So plan to add YouTube tags in YouTube Studio.

Two ways to fit that into a scheduled upload:

- **Publish, then tag.** Schedule the video as Public. After PostBoost has uploaded it, open it in YouTube Studio (**Content** → the video → **Show more**) and add the tags. Given how small a role tags play, this is fine for most videos.
- **Upload privately, tag, then go public.** Set **Privacy configuration** to **Private** in YouTube options, schedule it, add the tags in Studio once it is uploaded, and switch it to Public there. Nobody sees the video until it is complete.

What PostBoost does check is the metadata YouTube cares about more. In the composer, **YouTube options → Title** is required and capped at 100 characters, and the post cannot be scheduled until the title fits. Through the API, a post with a `<` or `>` in the title or description, or a description over 5,000 bytes, comes back with a `youtube_forbidden_characters` or `youtube_description_too_long` warning before YouTube refuses the upload. You can run those checks without creating anything:

```bash
curl -s -X POST "https://postboost.co/app/api/$WORKSPACE_UUID/posts/validate" \
  -H "Authorization: Bearer $POSTBOOST_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "accounts": [7],
    "versions": [{
      "account_id": 0,
      "is_original": true,
      "content": [
        { "body": "Shape a tight sourdough boule in 8 minutes, with the banneton timings in the chapters.", "media": [431] }
      ],
      "options": {
        "youtube": { "title": "Sourdough shaping for beginners: a tight boule in 8 minutes", "status": "private", "made_for_kids": false }
      }
    }]
  }'
```

The response lists `valid`, `errors`, `warnings` and `issues`. Send the same body to `POST /{workspaceUuid}/posts` with `"schedule": true`, a `date` and a `time` to schedule it ([validatePost](/docs/api/validate-post), [createPost](/docs/api/create-post)). With `"status": "private"`, the video waits in your channel for its tags. The video itself is the media id from your media library; see [YouTube Shorts length](/learn/youtube-shorts-length) for the upload steps and [YouTube thumbnail size](/learn/youtube-thumbnail-size) for the thumbnail.

The free generators cover the parts that do move discovery: the [YouTube title generator](/tools/youtube-title-generator) writes titles that fit in 100 characters with the main keyword early, and the [YouTube description generator](/tools/youtube-description-generator) writes descriptions with the hook in the first lines, your own chapter times and a size check against the 5,000-byte limit. If an AI agent drives your channel, both are in the API and on the [MCP server](/docs/mcp); see [social media API vs MCP](/learn/social-media-api-vs-mcp) for which one to pick.

To schedule YouTube videos with the title, description and forbidden characters checked for you, [start free](/app/register) and connect your YouTube channel.

## Do this in PostBoost

- [Post editor](https://postboost.co/features/editor): Write once, adjust per account, preview it the way each network shows it and pick the format: Reel, Story, thread, offer, board or privacy.

## Free tools for this guide

- [YouTube title generator](https://postboost.co/tools/youtube-title-generator): Write YouTube titles that fit the 100-character limit with the keyword first: a title formula, 8 templates and, when on, five AI title drafts. Free.
- [YouTube description generator](https://postboost.co/tools/youtube-description-generator): Write YouTube descriptions with the hook in the first lines, your own chapters and links as placeholders: a free template and, when on, three AI drafts.
- [Social media character counter](https://postboost.co/tools/social-media-character-counter): Free character counter for X, Threads, Bluesky, Instagram, LinkedIn, TikTok and more. Counts as each network does, live in your browser.

## FAQ

### What is the YouTube tags character limit?

500 characters for all tags on a video together. The YouTube Data API documents snippet.tags with a maximum length of 500 characters, counts the commas between tags toward that limit, and counts a tag that contains a space as if it were wrapped in quotation marks, so it costs 2 extra characters.

### How many tags can a YouTube video have?

YouTube sets no number of tags, only the 500-character budget. Short single-word tags fit more of them than long phrases. YouTube Help also warns that excessive tags are against its spam policies, so a few accurate tags beat a full field.

### Is there a character limit per YouTube tag?

YouTube does not document one. The Data API only limits the whole list to 500 characters. Some guides quote a per-tag limit of about 30 characters, but we found no YouTube source for it.

### Do YouTube tags still matter in 2026?

Less than most guides suggest. YouTube Help says the title, thumbnail and description are more important for discovery and that tags otherwise play a minimal role. Tags are most useful when the topic of your video is commonly misspelled.

### What is the difference between YouTube tags and hashtags?

Tags go in a separate Tags field in YouTube Studio and share 500 characters. Hashtags are written in the title or description with a # and no spaces, link to a hashtag results page, and up to three of them can show by the title. A video with more than 60 hashtags has all of them ignored.

### Can PostBoost add tags to a YouTube video?

No. PostBoost uploads the video with its title, description, privacy setting, Made for kids flag and AI-content disclosure, and sends no tags. The post-level tags field in the API is for PostBoost workspace tags and is not sent to YouTube. Add tags in YouTube Studio after the upload: Content, select the video, Show more. To add them before anyone sees the video, schedule it as Private and switch it to Public in Studio.

## Sources

- [YouTube Data API: Videos resource (snippet.tags 500 characters, commas count, tags with spaces count quotes)](https://developers.google.com/youtube/v3/docs/videos)
- [YouTube Help: Add tags to your YouTube videos](https://support.google.com/youtube/answer/146402?hl=en)
- [YouTube Help: Use hashtags for YouTube search (up to 3 by the title, more than 60 ignored)](https://support.google.com/youtube/answer/6390658?hl=en)
- [YouTube Data API: Videos insert (invalidTags error)](https://developers.google.com/youtube/v3/docs/videos/insert)
- [YouTube Data API: Videos update (omitted properties are deleted; title and categoryId required with snippet; 50 quota units)](https://developers.google.com/youtube/v3/docs/videos/update)
- [YouTube Help: Tips for video descriptions (1-2 main words in title and description)](https://support.google.com/youtube/answer/12948449?hl=en)

Canonical: https://postboost.co/learn/youtube-tags-character-limit
