The set() method of the cookies API sets a cookie containing the specified cookie data. This method is equivalent to issuing an HTTP Set-Cookie header during a request to a given URL.

The call succeeds only if you include the "cookies" API permission in your manifest.json file, as well as host permissions for the given URL specified in its manifest. The given URL also needs the necessary permissions to create a cookie with the given parameters.


  details,               // object
  function(cookie) {...} // optional function

This API is also available as browser.cookies.set() in a version that returns a promise.


An object containing the details of the cookie you wish to set. It can have the following properties:
A string representing the request-URI to associate with the cookie. This value can affect the default domain and path values of the created cookie. If host permissions for this URL are not specified in the manifest file, the method call will fail.
A string representing the name of the cookie. If omitted, this is empty by default.
A string representing the value of the cookie. If omitted, this is empty by default.
A string representing the domain of the cookie. If omitted, the cookie becomes a host-only cookie.
A string representing the path of the cookie. If omitted, this defaults to the path portion of the URL parameter.
A boolean that specifies whether the cookie should be marked as secure (true), or not (false). If omitted, it defaults to false.
A boolean that specifies whether the cookie should be marked as HttpOnly (true), or not (false). If omitted, it defaults to false.
A number that represents the expiration date of the cookie as the number of seconds since the UNIX epoch. If omitted, the cookie becomes a session cookie.
A string representing the ID of the cookie store in which to set the cookie. If omitted, the cookie is set in the current execution context's cookie store by default
A callback function, which is passed a cookies.Cookie object containing details about the cookie that's been set. If the call fails for any reason, this will be given a value of null, and runtime.lastError will be set.

Browser compatibility

Chrome Edge Firefox Firefox for Android Opera
Basic support Yes Yes 45.0 48.0 33


In this code snippet, taken from our cookie-bg-picker example, a function is run when the color picker form input has a new color entered into it. The tabs.query() method is first used to get information about the current tab, after which tabs.sendMessage() is used to send the new color choice to the content script so it can update the background of the page with the new color, and set() is used to save that preference in a cookie.

colorPick.onchange = function(e) {
  chrome.tabs.query({active: true, currentWindow: true}, function(tabs) {
    var currColor =;
    chrome.tabs.sendMessage(tabs[0].id, {color: currColor});

    cookieVal.color = currColor;
      url: tabs[0].url,
      name: "bgpicker",
      value: JSON.stringify(cookieVal)

Example add-ons


This API is based on Chromium's chrome.cookies API. This documentation is derived from cookies.json in the Chromium code.

Microsoft Edge compatibility data is supplied by Microsoft Corporation and is included here under the Creative Commons Attribution 3.0 United States License.

Document Tags and Contributors

 Contributors to this page: Makyen, wbamberg, chrisdavidmills, kmaglione
 Last updated by: Makyen,