Documentation | 2025.1

# Quick URLs quick reference

Swarm handles URLs intelligently to reduce the amount of information you need to enter to quickly locate what you are looking for:

1. Enter a URL in the following format:

https://myswarm.url/<identifier>

2. Swarm checks the `<identifier>` and redirects you to the first match it finds. Swarm checks for the identifier in following order:

   - Reviews
   - Changelists
   - Depot paths
   - Projects
   - Jobs
   - Users
   - Groups
   - Depot names

- Changelist and review identifiers must be numeric.
- If you enter an identifier that does not exist for any type of resource, Swarm displays a Page Not Found error.

### Example usage

#### Display the latest version of a review

For example, to display review 124: enter the URL `https://myswarm.url/124`, Swarm redirects to `https://myswarm.url/reviews/124`.

- To display a specific version of a review, enter the full URL including reviews and append /v<n>/to the URL. For example, to display version 2 of review 124: enter `https://myswarm.url/reviews/124/v2/`
- To display a diff between two versions of a review, enter the full URL including reviews and append /v<n,n>/ the URL. For example, to display the diff between version 2 and 4 of review 124: enter `https://myswarm.url/reviews/124/v2,4/`
- To open a review with a specific tab open, append #<tab name> to the end of the URL (#<tab name> must be the last item in the URL):
  - Files tab: #files (default if #<tab name> is not specified)
  - Comments tab: #comments
  - Activity tab: #activity

#### Display a changelist

For example, to display changelist 123: enter the URL `https://myswarm.url/123`, Swarm redirects to `https://myswarm.url/changes/123`.

To open a changelist with a specific tab open, append #<tab name> to the end of the URL:

- Files tab: #files (default if #<tab name> is not specified)
- Comments tab: #comments

#### Display the latest version of a file

Enter the URL `https://myswarm.url/depot/alpha/readme.txt`, Swarm redirects to `https://myswarm.url/files/depot/alpha/readme.txt`.

- To display a specific version of a file, enter the full URL including files and append ?v=<n> to the URL. For example, to display version 2 of the depot/alpha/readme.txt file: enter `https://myswarm.url/files/depot/alpha/readme.txt?v=2`
- To open a file with a specific tab open, append #<tab name> to the end of the URL (#<tab name> must be the last item in the URL):
  - View tab: #view (default if #<tab name> is not specified)
  - Commits tab: #commits

#### Display the user profile page for jsmith

Enter the URL `https://myswarm.url/jsmith`, Swarm redirects to `https://myswarm.url/users/jsmith`.

Your search for returned results