Bing Webmaster CLI

Site settings

Manage sites, verification, users, URL parameters, blocked URLs, preview blocks, geo-targeting, deep-link blocks, and crawl rate with bwt.

Every command on this page that changes Bing state is blocked by --read-only, and --dry-run prints its request without sending it.

Sites

bwt sites list                               # use these URLs exactly in other commands
bwt sites add https://www.example.com/
bwt sites verify https://www.example.com/    # after adding the XML file, meta tag, or DNS record
bwt sites use https://www.example.com/       # the profile's default site (local only)
bwt sites remove https://old.example.com/

sites list -o json includes each site's AuthenticationCode and DnsVerificationCode for verification. sites verify prints verified: false when Bing could not confirm ownership.

Users and roles

bwt users list --all-subdomains
bwt users add colleague@example.com --role read-only
bwt users remove colleague@example.com

Roles are admin, read-only, and read-write. --delegated-url targets a host under the site.

URL parameters

Query parameters Bing should ignore when normalizing URLs:

bwt params list
bwt params add sessionid
bwt params disable sessionid    # or: enable, remove

Blocked URLs and previews

bwt block list
bwt block add https://www.example.com/private/ --type directory --request cache-only
bwt block remove https://www.example.com/private/

bwt preview-blocks list
bwt preview-blocks add https://www.example.com/page --reason 1
bwt preview-blocks remove https://www.example.com/page

block add has no default --request: cache-only removes the cached copy, and full-removal removes the URL from Bing results until it expires (and asks for confirmation). Microsoft does not publish the preview --reason values; 1 is ContentNeedsToBeRemoved.

bwt geo list
bwt geo add --url https://www.example.com/uk/ --type directory --country gb
bwt geo remove --url https://www.example.com/uk/ --type directory --country gb

bwt deeplink-blocks list
bwt deeplink-blocks add --market en-US --search-url https://www.example.com/ \
  --deep-link-url https://www.example.com/old-page

Bing accepts only lowercase country and market codes; bwt lowercases them for you.

Connected pages

bwt connected-pages list
bwt connected-pages add https://social.example.com/your-profile

Crawl rate and boost

bwt crawl settings
bwt crawl set-settings --boost on
bwt crawl set-settings --rate 5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,6,6,6,5,4,3,3,4

set-settings reads the current settings, applies your change, and saves the full object. --rate takes 24 hourly values; Bing does not document their valid range or timezone.

Site moves (experimental)

bwt experimental site-move list
bwt experimental site-move submit --from https://old.example.com/ --to https://www.example.com/ \
  --scope host --type global

Bing still documents these methods, but GetSiteMoves returned HTTP 404 in a live check. Each run prints a notice; confirm the result in the Bing Webmaster Tools dashboard.

On this page