> For the complete documentation index, see [llms.txt](https://handles.gitbook.io/handles/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://handles.gitbook.io/handles/spec/handles-protocol/indexing-reference-guide.md).

# Indexing Reference Guide

This page provides examples of both acceptable and unacceptable @handle name registration

## Simple Registration

<table><thead><tr><th width="171">Scenario</th><th width="133">Inscription</th><th width="100">Valid</th><th>Rule</th></tr></thead><tbody><tr><td>Default</td><td>@handle</td><td><mark style="color:green;">Yes</mark></td><td>Standard</td></tr><tr><td>Capitalization</td><td>@Handle</td><td><mark style="color:green;">Yes</mark></td><td>All caps will be indexed lowercase</td></tr><tr><td>Space in front</td><td> @handle</td><td><mark style="color:red;">No</mark></td><td>First character must be an @</td></tr><tr><td>Space in back</td><td>@handle </td><td><mark style="color:green;">Yes</mark></td><td>Everything after a space is ignored</td></tr><tr><td>Newline in front</td><td><br>@handle</td><td><mark style="color:red;">No</mark></td><td>First character must be an @</td></tr><tr><td>Newline in back</td><td>@handle<br></td><td><mark style="color:green;">Yes</mark></td><td>Everything after a space is ignored</td></tr><tr><td>Space in name</td><td>@han dle</td><td><mark style="color:red;">No</mark></td><td>Everything after a space is ignored</td></tr><tr><td>Accepted symbols</td><td>@hand-le_</td><td><mark style="color:green;">Yes</mark></td><td>Letters, numbers, underscores (_), and hyphen (-) only</td></tr><tr><td>Unaccepted symbols</td><td>@handle!</td><td><mark style="color:red;">No</mark></td><td>Letters, numbers, underscores (_), and hyphen (-) only</td></tr><tr><td>Emoji</td><td>@handle🙂</td><td><mark style="color:red;">No</mark></td><td>Letters, numbers, underscores (_), and hyphen (-) only</td></tr></tbody></table>

## Advanced Registration

All simple registration rules apply with some JSON-specific adjustments:

<table><thead><tr><th width="173">Scenario</th><th width="373">inscription</th><th width="77">Valid?</th><th>Rule</th></tr></thead><tbody><tr><td>Default</td><td>{ "p": "@handles", "op": "data", "name": "@handle" }</td><td><mark style="color:green;">Yes</mark></td><td>Valid JSON5</td></tr><tr><td>Trailing commas</td><td>{ "p": "@handles", "op": "data", "name": "@handle", }</td><td><mark style="color:green;">Yes</mark></td><td>Valid JSON5</td></tr><tr><td>Newline OUTSIDE of keys or values</td><td>{ "p": "@handles", <br>"op": "data",<br> "name": "@handle" }<br></td><td><mark style="color:green;">Yes</mark></td><td>Valid JSON5</td></tr><tr><td>Newline INSIDE of keys or values</td><td>{ "p": "@handles", "op": "data", "name": "@handle<br>" }</td><td><mark style="color:red;">No</mark></td><td>Invalid JSON5</td></tr></tbody></table>