HTTP/2 302
cache-control: no-store
location: /en-US/docs/Mozilla/Add-ons/WebExtensions/API/browserAction/setBadgeText
vary: Accept
content-type: text/plain; charset=utf-8
x-cloud-trace-context: 0cd8f8c5277136098813fe31b34dac20
date: Tue, 14 Oct 2025 01:27:52 GMT
server: Google Frontend
content-length: 94
via: 1.1 google
x-cache: miss
alt-svc: clear
HTTP/2 200
content-type: text/html
x-guploader-uploadid: AAwnv3KRtSkD32bXAL-jlMR7h_BrKdJZy3Cb5xY9ubheTrapDWp6JRAgT1oEB2myS1Ul4RFU
cache-control: public, max-age=3600
expires: Tue, 14 Oct 2025 02:27:52 GMT
last-modified: Tue, 14 Oct 2025 01:04:26 GMT
etag: W/"691877bba306ad7d168840e9ef76cffd"
x-goog-generation: 1760403866548630
x-goog-metageneration: 1
x-goog-stored-content-encoding: identity
x-goog-stored-content-length: 151889
x-goog-meta-goog-reserved-file-mtime: 1760402647
x-goog-hash: crc32c=FICw9w==, md5=aRh3u6MGrX0WiEDp73bP/Q==
x-goog-storage-class: STANDARD
accept-ranges: none
alt-svc: h3=":443"; ma=2592000,h3-29=":443"; ma=2592000
alt-svc: clear
referrer-policy: strict-origin-when-cross-origin
x-content-type-options: nosniff
strict-transport-security: max-age=63072000
content-security-policy: default-src 'self'; script-src 'report-sample' 'self' 'wasm-unsafe-eval' https://www.google-analytics.com/analytics.js https://www.googletagmanager.com/gtag/js assets.codepen.io production-assets.codepen.io https://js.stripe.com 'sha256-XNBp89FG76amD8BqrJzyflxOF9PaWPqPqvJfKZPCv7M=' 'sha256-YCNoU9DNiinACbd8n6UPyB/8vj0kXvhkOni9/06SuYw=' 'sha256-PZjP7OR6mBEtnvXIZfCZ5PuOlxoDF1LDZL8aj8c42rw='; script-src-elem 'report-sample' 'self' 'wasm-unsafe-eval' https://www.google-analytics.com/analytics.js https://www.googletagmanager.com/gtag/js assets.codepen.io production-assets.codepen.io https://js.stripe.com 'sha256-XNBp89FG76amD8BqrJzyflxOF9PaWPqPqvJfKZPCv7M=' 'sha256-YCNoU9DNiinACbd8n6UPyB/8vj0kXvhkOni9/06SuYw=' 'sha256-PZjP7OR6mBEtnvXIZfCZ5PuOlxoDF1LDZL8aj8c42rw='; style-src 'report-sample' 'self' 'unsafe-inline'; object-src 'none'; base-uri 'self'; connect-src 'self' developer.allizom.org bcd.developer.allizom.org bcd.developer.mozilla.org updates.developer.allizom.org updates.developer.mozilla.org https://*.google-analytics.com https://*.analytics.google.com https://*.googletagmanager.com https://incoming.telemetry.mozilla.org https://observatory-api.mdn.allizom.net https://observatory-api.mdn.mozilla.net https://api.github.com/search/issues stats.g.doubleclick.net https://api.stripe.com; font-src 'self'; frame-src 'self' interactive-examples.mdn.mozilla.net interactive-examples.mdn.allizom.net mdn.github.io live-samples.mdn.mozilla.net live-samples.mdn.allizom.net *.mdnplay.dev *.mdnyalp.dev *.play.test.mdn.allizom.net https://v2.scrimba.com https://scrimba.com jsfiddle.net www.youtube-nocookie.com codepen.io survey.alchemer.com https://js.stripe.com; img-src 'self' data: *.githubusercontent.com *.googleusercontent.com *.gravatar.com mozillausercontent.com firefoxusercontent.com profile.stage.mozaws.net profile.accounts.firefox.com developer.mozilla.org mdn.dev interactive-examples.mdn.mozilla.net interactive-examples.mdn.allizom.net wikipedia.org upload.wikimedia.org https://mdn.github.io/shared-assets/ https://mdn.dev/ https://*.google-analytics.com https://*.googletagmanager.com www.gstatic.com; manifest-src 'self'; media-src 'self' archive.org videos.cdn.mozilla.net https://mdn.github.io/shared-assets/; child-src 'self'; worker-src 'self';
x-frame-options: DENY
origin-trial: AxVILwizhbMjxFeHOn1P3R8niO1RJY/smaK4B4d1rLzc1gTaxtXMSaTi+FoigYgCw40uFRDwFcEAeqDR+vVLOW4AAABfeyJvcmlnaW4iOiJodHRwczovL2RldmVsb3Blci5tb3ppbGxhLm9yZyIsImZlYXR1cmUiOiJQcml2YXRlQXR0cmlidXRpb25WMiIsImV4cGlyeSI6MTc0MjA3OTYwMH0=
x-cloud-trace-context: af637d31a7b3666e8813fe31b34dac81
date: Tue, 14 Oct 2025 01:27:53 GMT
server: Google Frontend
via: 1.1 google
vary: Accept-Encoding
content-encoding: gzip
x-cache: miss
browserAction.setBadgeText() - Mozilla | MDN
browser.browserAction.setBadgeText(
details // object
)
This API is also available as chrome.browserAction.setBadgeText()
.
details
An object with the following properties:
text
string
or null
. Any number of characters can be passed, but only about four can fit in the space.
Use an empty string - ""
- if you don't want any badge.
If a tabId
is specified, null
removes the tab-specific badge text so that the tab inherits the global badge text. Otherwise it reverts the global badge text to ""
.
If a windowId
is specified, null
removes the window-specific badge text so that the tab inherits the global badge text. Otherwise it reverts the global badge text to ""
.
tabId
Optional
integer
. Set the badge text only for the given tab. The text is reset when the user navigates this tab to a new page.
windowId
Optional
integer
. Set the badge text for the given window.
If windowId
and tabId
are both supplied, the function fails.
If windowId
and tabId
are both omitted, the global badge is set.
Add a badge indicating how many times the user clicked the button:
let clicks = 0;
function increment() {
browser.browserAction.setBadgeText({ text: (++clicks).toString() });
}
browser.browserAction.onClicked.addListener(increment);