Filter, sort, and page through extensions

3 min readStableIntermediate

Every flag for narrowing, ordering, and paging the extension catalog. They work the same way whether you're browsing with reserve extensions or checking a real name. A filter you add before or after the subcommand means the same thing either way, and every filter combines with every other one.

Prerequisites

reserve installed. See Install reserve.
A starting selection: a group (--group), specific extensions (--tld), or no selection at all, which starts from everything. See Check whether a domain name is available.

Filter by text, industry, or region

-s, --searchtext

Keeps only extensions matching this text: the extension name, its country, its region, or its industries.

--industrykey[]

Keeps only extensions marketed for the given industry or industries. Comma-separate or repeat the flag; several values match any one of them.

--regionkey[]

Keeps only country extensions from the given region or regions. Same comma-or-repeat rule as --industry.

Run reserve groups to see the current industry and region keys.

CONSOLE

$ reserve extensions --search crypto
 
EXTENSION  RANK  KIND     USED FOR
xyz           7  generic  tech, creative, crypto
io           42  country  British Indian Ocean Territory · tech, cryp…
cash          -  generic  finance, crypto
exchange      -  generic  finance, crypto
markets       -  generic  finance, crypto
money         -  generic  finance, crypto
trading       -  generic  finance, crypto
 
1-7 of 7 extensions · page 1 of 1 · sorted by popularity (most used first)

CONSOLE

$ reserve extensions --region europe --industry tech
 
EXTENSION  RANK  KIND     USED FOR
is            -  country  Iceland · tech · often used off-label
 
1-1 of 1 extensions · page 1 of 1 · sorted by popularity (most used first)

Filter by country code, depth, or length

--cctldboolean

Keeps only two-letter country extensions.

--depthany | second | thirdDefault: any

second keeps plain single-label extensions such as com; third keeps multi-label ones such as co.uk; the default, any, keeps both.

--lengthspec

Filters by length, measured on the delegated label (so co.uk counts as two characters). Four forms: 2 (exactly 2), -3 (3 or fewer), 4- (4 or more), 2-4 (between 2 and 4). Each bound must be between 1 and 63.

CONSOLE

$ reserve extensions --region europe --cctld
 
EXTENSION  RANK  KIND     USED FOR
de            3  country  Germany · business
uk            6  country  United Kingdom · business
nl            9  country  Netherlands · business
ru           10  country  Russia · business
fr           13  country  France · business
...

CONSOLE

$ reserve extensions --depth second --length -3
 
EXTENSION  RANK  KIND     USED FOR
com           1  generic  business, tech, shop
cn            2  country  China · business
de            3  country  Germany · business
net           4  generic  tech, business
org           5  generic  nonprofit, education
...

Exclude extensions or include restricted zones

-x, --excludeext[]

Drops an extension from whatever else was chosen. Comma-separate or repeat it for several.

--include-restrictedboolean

Adds zones that carry eligibility conditions, hidden by default. Zones the public can't register under are excluded from a sweep unless you pass this, so a free name in a zone nobody can buy is never offered as available.

CONSOLE

$ reserve extensions -g top-25 -x com -x net
 
EXTENSION  RANK  KIND     USED FOR
cn            2  country  China · business
de            3  country  Germany · business
org           5  generic  nonprofit, education
uk            6  country  United Kingdom · business
xyz           7  generic  tech, creative, crypto
...
 
1-20 of 20 extensions · page 1 of 1 · sorted by popularity (most used first)

Sort the list

--sortname | popularity | lengthDefault: popularity

popularity counts down (most used first) by default; name and length count up unless you say otherwise. An extension with no rank always sorts to the bottom, whichever direction you choose. Ties break alphabetically by extension.

--orderasc | desc

Overrides the field's natural direction.

CONSOLE

$ reserve extensions --sort length --order asc
 
EXTENSION  RANK  KIND     USED FOR
ae           82  country  United Arab Emirates · business
af            -  country  Afghanistan · business
ai           41  country  Anguilla · tech · often used off-label
as            -  country  American Samoa · business · often used off-…
at           37  country  Austria · business
...

Bash

reserve extensions --sort popularity          # most registered first
reserve extensions --sort length --order asc  # shortest first
reserve extensions --sort name --order desc   # z to a

Page through the results

--pageintegerDefault: 1

Which page to show, starting at 1. When checking a name rather than browsing, this decides which extensions actually get contacted, not just what gets printed.

--page-sizeinteger

Rows per page. Defaults to what your terminal fits when browsing, and to 25 extensions when checking a name.

--all-pagesboolean

Prints every page at once. Conflicts with --page, so the two can't be given together.

CONSOLE

$ reserve extensions --group tech --page-size 6
 
EXTENSION  RANK  KIND     USED FOR
com           1  generic  business, tech, shop
net           4  generic  tech, business
xyz           7  generic  tech, creative, crypto
co           21  country  Colombia · business, tech · often used off-…
site         30  generic  tech, creative
app          35  generic  tech
 
1-6 of 34 extensions · page 1 of 6 · sorted by popularity (most used first)
next: --page 2  |  --all-pages

Bash

reserve extensions -g everything --page 3
reserve extensions -g everything --page-size 40
reserve extensions -g everything --all-pages

The footer line always states the range, the total, the page number, the page count, and the active sort. The next: line lists a previous-page flag when there is one, a next-page flag when there is one, and always --all-pages. It only appears when there's more than one page. Asking for a page past the end clamps back to the last real page.

Check whether a domain name is available

reserve command reference

Was this page helpful?

Filter, sort, and page through extensions

Prerequisites

Filter by text, industry, or region

Filter by country code, depth, or length

Exclude extensions or include restricted zones

Sort the list

Page through the results

Related pages

Check whether a domain name is available

reserve command reference