diff --git a/microsoft-edge/devtools/storage/cookies-images/3rd-party-cookies-application-tool.png b/microsoft-edge/devtools/storage/cookies-images/3rd-party-cookies-application-tool.png new file mode 100644 index 0000000000..d9ef15852b Binary files /dev/null and b/microsoft-edge/devtools/storage/cookies-images/3rd-party-cookies-application-tool.png differ diff --git a/microsoft-edge/devtools/storage/cookies-images/add-cookie.png b/microsoft-edge/devtools/storage/cookies-images/add-cookie.png new file mode 100644 index 0000000000..c44516a8d7 Binary files /dev/null and b/microsoft-edge/devtools/storage/cookies-images/add-cookie.png differ diff --git a/microsoft-edge/devtools/storage/cookies-images/application-icon.png b/microsoft-edge/devtools/storage/cookies-images/application-icon.png new file mode 100644 index 0000000000..c0cd3c6ca9 Binary files /dev/null and b/microsoft-edge/devtools/storage/cookies-images/application-icon.png differ diff --git a/microsoft-edge/devtools/storage/cookies-images/cookie-blocked-application-tool.png b/microsoft-edge/devtools/storage/cookies-images/cookie-blocked-application-tool.png new file mode 100644 index 0000000000..e59f690bd3 Binary files /dev/null and b/microsoft-edge/devtools/storage/cookies-images/cookie-blocked-application-tool.png differ diff --git a/microsoft-edge/devtools/storage/cookies-images/customize-and-control-devtools-icon.png b/microsoft-edge/devtools/storage/cookies-images/customize-and-control-devtools-icon.png new file mode 100644 index 0000000000..da26f09442 Binary files /dev/null and b/microsoft-edge/devtools/storage/cookies-images/customize-and-control-devtools-icon.png differ diff --git a/microsoft-edge/devtools/storage/cookies-images/info-icon-tooltip.png b/microsoft-edge/devtools/storage/cookies-images/info-icon-tooltip.png new file mode 100644 index 0000000000..57d2784461 Binary files /dev/null and b/microsoft-edge/devtools/storage/cookies-images/info-icon-tooltip.png differ diff --git a/microsoft-edge/devtools/storage/cookies-images/information-icon.png b/microsoft-edge/devtools/storage/cookies-images/information-icon.png new file mode 100644 index 0000000000..290e329a07 Binary files /dev/null and b/microsoft-edge/devtools/storage/cookies-images/information-icon.png differ diff --git a/microsoft-edge/devtools/storage/cookies-images/network-tool-blocked-cookies.png b/microsoft-edge/devtools/storage/cookies-images/network-tool-blocked-cookies.png new file mode 100644 index 0000000000..3728726ea3 Binary files /dev/null and b/microsoft-edge/devtools/storage/cookies-images/network-tool-blocked-cookies.png differ diff --git a/microsoft-edge/devtools/storage/cookies-images/open-cookies-select-source.png b/microsoft-edge/devtools/storage/cookies-images/open-cookies-select-source.png index 03f1520688..45a7a2f736 100644 Binary files a/microsoft-edge/devtools/storage/cookies-images/open-cookies-select-source.png and b/microsoft-edge/devtools/storage/cookies-images/open-cookies-select-source.png differ diff --git a/microsoft-edge/devtools/storage/cookies-images/pick-application-no-manifest.png b/microsoft-edge/devtools/storage/cookies-images/pick-application-no-manifest.png deleted file mode 100644 index ef76b4fe1f..0000000000 Binary files a/microsoft-edge/devtools/storage/cookies-images/pick-application-no-manifest.png and /dev/null differ diff --git a/microsoft-edge/devtools/storage/cookies-images/settings-and-more-icon.png b/microsoft-edge/devtools/storage/cookies-images/settings-and-more-icon.png new file mode 100644 index 0000000000..63d9f0fdad Binary files /dev/null and b/microsoft-edge/devtools/storage/cookies-images/settings-and-more-icon.png differ diff --git a/microsoft-edge/devtools/storage/cookies.md b/microsoft-edge/devtools/storage/cookies.md index 3469fee9bc..fe34baf4cd 100644 --- a/microsoft-edge/devtools/storage/cookies.md +++ b/microsoft-edge/devtools/storage/cookies.md @@ -6,7 +6,7 @@ ms.author: msedgedevrel ms.topic: article ms.service: microsoft-edge ms.subservice: devtools -ms.date: 07/21/2023 +ms.date: 03/05/2026 --- # View, edit, and delete cookies + + _HTTP cookies_ are used to manage user sessions, store user personalization preferences, and track user behavior. Use the **Cookies** pane of the **Application** tool to view, edit, and delete the HTTP cookies for a webpage. -See [Using HTTP cookies](https://developer.mozilla.org/docs/Web/HTTP/Cookies). +See also: +* [Using HTTP cookies](https://developer.mozilla.org/docs/Web/HTTP/Cookies) at MDN. + +**Detailed contents:** +* [Open the Cookies pane](#open-the-cookies-pane) +* [Fields](#fields) +* [Filter cookies](#filter-cookies) +* [Add a cookie](#add-a-cookie) +* [Edit a cookie](#edit-a-cookie) +* [Delete cookies](#delete-cookies) +* [Identify and inspect third-party cookies](#identify-and-inspect-third-party-cookies) + * [View third-party cookies in the Application tool](#view-third-party-cookies-in-the-application-tool) + * [View blocked third-party cookies in the Application tool](#view-blocked-third-party-cookies-in-the-application-tool) + * [View blocked third-party cookies in the Network tool](#view-blocked-third-party-cookies-in-the-network-tool) ## Open the Cookies pane + + +1. Go to a webpage, such [Bing.com](https://www.bing.com). -1. Open DevTools by pressing **F12** or **Ctrl+Shift+I** (Windows, Linux) or **Command+Option+I** (macOS). +1. Right-click the webpage, and then select **Inpsect**. -1. In DevTools, on the **Activity Bar**, select the **Application** tab. If that tab isn't visible, click the **More tools** (![More tools icon](./cookies-images/more-tools-icon.png)) button, and then click **Application**. The **Manifest** pane usually opens by default: + DevTools opens. - ![The Manifest pane](./cookies-images/pick-application-no-manifest.png) +1. In the **Activity Bar**, select the **Application** (![Application icon](./cookies-images/application-icon.png)) tool. -1. Under **Storage**, expand **Cookies**, then select an origin: +1. In the outline on the left, in the major **Storage** section, expand **Cookies**, then select an origin, such as **https://www.bing.com**: ![The Cookies pane](./cookies-images/open-cookies-select-source.png) ## Fields + The **Cookies** table contains the following fields: -* **Name**. The name of the cookie. +* **Name**. The name of the cookie. -* **Value**. The value of the cookie. +* **Value**. The value of the cookie. -* **Domain**. The hosts that are allowed to receive the cookie. See [Scope of cookies](https://developer.mozilla.org/docs/Web/HTTP/Cookies#Scope_of_cookies). +* **Domain**. The hosts that are allowed to receive the cookie. See [Scope of cookies](https://developer.mozilla.org/docs/Web/HTTP/Cookies#Scope_of_cookies). -* **Path**. The URL that must exist in the requested URL in order to send the `Cookie` header. See [Scope of cookies](https://developer.mozilla.org/docs/Web/HTTP/Cookies#Scope_of_cookies). +* **Path**. The URL that must exist in the requested URL in order to send the `Cookie` header. See [Scope of cookies](https://developer.mozilla.org/docs/Web/HTTP/Cookies#Scope_of_cookies). -* **Expires / Max-Age**. The expiration date or maximum age of the cookie. See [Permanent cookies](https://developer.mozilla.org/docs/Web/HTTP/Cookies#Permanent_cookies). For [session cookies](https://developer.mozilla.org/docs/Web/HTTP/Cookies#Session_cookies) this value is always `Session`. +* **Expires / Max-Age**. The expiration date or maximum age of the cookie. See [Permanent cookies](https://developer.mozilla.org/docs/Web/HTTP/Cookies#Permanent_cookies). For [session cookies](https://developer.mozilla.org/docs/Web/HTTP/Cookies#Session_cookies) this value is always `Session`. -* **Size**. The size, in bytes, of the cookie. +* **Size**. The size, in bytes, of the cookie. -* **HttpOnly**. If `true`, this field indicates that the cookie should only be used over HTTP, and JavaScript modification isn't allowed. See [HttpOnly cookies](https://developer.mozilla.org/docs/Web/HTTP/Cookies#Secure_and_HttpOnly_cookies). +* **HttpOnly**. If `true`, this field indicates that the cookie should only be used over HTTP, and JavaScript modification isn't allowed. See [HttpOnly cookies](https://developer.mozilla.org/docs/Web/HTTP/Cookies#Secure_and_HttpOnly_cookies). -* **Secure**. If `true`, this field indicates that the cookie must be sent to the server only over a secure, HTTPS connection. See [Secure cookies](https://developer.mozilla.org/docs/Web/HTTP/Cookies#Secure_and_HttpOnly_cookies). +* **Secure**. If `true`, this field indicates that the cookie must be sent to the server only over a secure, HTTPS connection. See [Secure cookies](https://developer.mozilla.org/docs/Web/HTTP/Cookies#Secure_and_HttpOnly_cookies). -* **SameSite**. Contains `strict` or `lax` if the cookie is using the experimental [Samesite](https://developer.mozilla.org/docs/Web/HTTP/Cookies#SameSite_cookies) attribute. +* **SameSite**. Contains `strict` or `lax` if the cookie is using the experimental [Samesite](https://developer.mozilla.org/docs/Web/HTTP/Cookies#SameSite_cookies) attribute. -* **SameParty**. This attribute provides web developers a means to annotate cookies that are allowed to be set or sent in same-party, cross-site contexts. +* **Partition Key Site**. The _partition key_ of a cookie only exists when the cookie is set in partitioned storage and corresponds to the top-level site where the cookie was initially created. See [Cookies Having Independent Partitioned State (CHIPS)](https://developer.mozilla.org/docs/Web/Privacy/Guides/Privacy_sandbox/Partitioned_cookies) at MDN. -* **Partition Key**. The _partition key_ of a cookie only exists when the cookie is set in partitioned storage and corresponds to the top-level site where the cookie was initially created. See [Cookies Having Independent Partitioned State (CHIPS)](https://developer.mozilla.org/docs/Web/Privacy/Guides/Privacy_sandbox/Partitioned_cookies) at MDN. +* **Cross Site**. This attribute provides web developers a means to annotate cookies that are allowed to be set or sent in same-party, cross-site contexts. -* **Priority**. Contains `low`, `medium` (default), or `high` if the cookie is using the deprecated [Cookie Priority](https://bugs.chromium.org/p/chromium/issues/detail?id=232693) attribute. +* **Priority**. Contains `low`, `medium` (default), or `high` if the cookie is using the deprecated [Cookie Priority](https://bugs.chromium.org/p/chromium/issues/detail?id=232693) attribute. ## Filter cookies + To filter cookies by **Name** or **Value**, use the **Filter** text box: ![Filtering out any cookies that don't contain the text ID](./cookies-images/filter-cookies-name.png) -**Note:** Filtering by other fields isn't supported. +Filtering by other fields isn't supported. Filter is case-insensitive. + + + +## Add a cookie + + +To add an arbitrary cookie: + +1. [Open the Cookies pane](#open-the-cookies-pane), as described above. + +1. In the empty row at the bottom of the table, double-click the **Name** column, enter a name for the cookie, and then press **Enter**. + +1. In the **Value** column of that row, enter a value for the cookie, and then press **Enter**. + +![Adding text in the Name and Value cells of an empty row](./cookies-images/add-cookie.png) + +DevTools populates other required fields automatically. You can edit them as described next. + ## Edit a cookie + The **Name**, **Value**, **Domain**, **Path**, and **Expires / Max-Age** fields are editable. Double-click a field to edit it: ![Setting the name of a cookie to 'DEVTOOLS!'](./cookies-images/rename-cookie.png) + ## Delete cookies + To delete a specific cookie, click a cookie and then click **Delete Selected** (![Delete Selected](./cookies-images/delete-cookie-icon.png)): @@ -100,6 +141,143 @@ To delete all cookies, click **Clear all cookies** (![Clear all cookies icon](./ ![Clearing all cookies](./cookies-images/clear-all-cookies.png) + +## Identify and inspect third-party cookies + + +Third-party cookies are those set by a site that's different from the current top-level page. Third-party cookies have the `SameSite=None` attribute. + + + +#### View third-party cookies in the Application tool + + +To view third-party cookies: + +1. Go to a webpage that uses third-party cookies, such as [Bing.com](https://www.bing.com), in a new window or tab. + +1. Right-click the webpage, and then select **Inspect**. + + DevTools opens. + +1. Select the **Application** (![Application icon](./cookies-images/application-icon.png)) tool. + +1. On the left, under the major **Storage** section, expand **Cookies**, and then select a website URL, such as **https://www.bing.com**. + + Third-party cookies are indicated in the table by the presence of the value **None** in the **SameSite** column. + + ![Third-party cookies in the Application tool](./cookies-images/3rd-party-cookies-application-tool.png) + + + +#### View blocked third-party cookies in the Application tool + + +Depending on your privacy settings, Microsoft Edge might prevent sites from using third-party cookies. + +DevTools lists blocked third-party cookies in **Application** > **Storage** > **Cookies** and shows a (![Information icon](./cookies-images/information-icon.png)) icon next to them. Hover over the icon to see a tooltip. Details are below. + +To view third-party cookies in the **Application** tool: + +1. Go to a webpage that uses third-party cookies, such as [Bing.com](https://www.bing.com), in a new window or tab. + +1. In Microsoft Edge, select **Settings and more** (![Settings and more icon](./cookies-images/settings-and-more-icon.png)) > **Settings** > **Privacy, search, and services**. + + The Edge **Settings** tab opens, showing the **Privacy, search, and services** page. + +1. Select **Cookies**, and then turn on the **Block third-party cookies** toggle. + +1. Switch back to the webpage's tab. + +1. Right-click the webpage, and then select **Inspect**. + + DevTools opens. + +1. Select the **Application** (![Application icon](./cookies-images/application-icon.png)) tool. + +1. Switch to the webpage window, such as Bing.com. + +1. Refresh the page. + +1. On the left, in the major **Storage** section, expand **Cookies**, and then select a website URL, such as **https://www.bing.com**. + +1. In the table of cookies, scroll to a row that has an **Information** icon (![Information icon](./cookies-images/information-icon.png)). + +1. Hover over the **Information** icon (![Information icon](./cookies-images/information-icon.png)). + + A tooltip reads **This attempt to set a cookie via a Set-Cookie header was blocked due to user preferences.** + + ![Cookies in Application tool that are blocked have an info icon](./cookies-images/cookie-blocked-application-tool.png) + + **Stop blocking third-party cookies:** + +1. In Microsoft Edge, select **Settings and more** (![Settings and more icon](./cookies-images/settings-and-more-icon.png)) > **Settings** > **Privacy, search, and services**. + + The Edge **Settings** tab opens, showing the **Privacy, search, and services** page. + +1. Select **Cookies**, and then turn on the **Block third-party cookies** toggle. + + + +#### View blocked third-party cookies in the Network tool + + +To view blocked third-party cookies in the **Network** tool: + +1. Go to a webpage that uses third-party cookies, such as [Bing.com](https://www.bing.com), in a new window or tab. + +1. In Microsoft Edge, select **Settings and more** (![Settings and more icon](./cookies-images/settings-and-more-icon.png)) > **Settings** > **Privacy, search, and services**. + + The Edge **Settings** tab opens, showing the **Privacy, search, and services** page. + +1. Select **Cookies**, and then turn on the **Block third-party cookies** toggle. + +1. Switch back to the webpage's tab. + +1. Right-click the webpage, and then select **Inspect**. + + DevTools opens. + +1. Select the **Network** tool. + +1. Refresh the page. + + The **Name** list displays more items. + +1. In the **Name** list, scroll up to the topmost entry for the domain, such as the topmost **www.bing.com** entry, and then select it. + +1. In the sidebar to the right, select the **Cookies** tab: + + ![Blocked cookies in the Network tool](./cookies-images/network-tool-blocked-cookies.png) + +1. Select the **Show filtered-out request cookies** checkbox. + + The **Network** tool highlights cookies that have issues, and shows an information (![Information icon](./cookies-images/information-icon.png)) icon next to cookies that are affected (blocked), where third-party cookies are not available. For example, the information (![Information icon](./cookies-images/information-icon.png)) icon might appear in the **Domain** column and **Path** column: + + ![Information icon tooltip on blocked cookie rows](./cookies-images/info-icon-tooltip.png) + + The tooltip in the **Domain** column reads, for example: + + "This cookie was blocked because neither did the request URL's domain exactly match the cookie's domain, nor was the request URL's domain a subdomain of the cookie's Domain attribute value." + + The tooltip in the **Path** column reads, for example: + + "This cookie was blocked because its path was not an exact match for or a superdirectory of the request url's path." + + **Stop blocking third-party cookies:** + +1. In the **Network** tool, in the **Cookies** tab, clear the **Show filtered-out request cookies** checkbox. + +1. In Microsoft Edge, select **Settings and more** (![Settings and more icon](./cookies-images/settings-and-more-icon.png)) > **Settings** > **Privacy, search, and services**. + + The Edge **Settings** tab opens, showing the **Privacy, search, and services** page. + +1. Select **Cookies**, and then turn off the **Block third-party cookies** toggle. + +See also: +* [Display cookies](../network/reference.md#display-cookies) in _Network features reference_. +* [Show only the requests with blocked response cookies](../network/reference.md#show-only-the-requests-with-blocked-response-cookies) in _Network features reference_. + > [!NOTE] diff --git a/scripts/package-lock.json b/scripts/package-lock.json index 4bd1e90e7e..36e8a85b39 100644 --- a/scripts/package-lock.json +++ b/scripts/package-lock.json @@ -1714,10 +1714,9 @@ } }, "node_modules/liquidjs": { - "version": "10.20.2", - "resolved": "https://registry.npmjs.org/liquidjs/-/liquidjs-10.20.2.tgz", - "integrity": "sha512-MbAueOtO8aH+GzC/kmhcJTiMrMu+MVel/3+yhFVmP3K89WP0ZuvVPi8ZRKCHAO6SLJvV0Y0Jz6tUEy6Hg8xO/g==", - "license": "MIT", + "version": "10.25.0", + "resolved": "https://registry.npmjs.org/liquidjs/-/liquidjs-10.25.0.tgz", + "integrity": "sha512-XpO7AiGULTG4xcTlwkcTI5JreFG7b6esLCLp+aUSh7YuQErJZEoUXre9u9rbdb0057pfWG4l0VursvLd5Q/eAw==", "dependencies": { "commander": "^10.0.0" }, @@ -1726,7 +1725,7 @@ "liquidjs": "bin/liquid.js" }, "engines": { - "node": ">=14" + "node": ">=16" }, "funding": { "type": "opencollective", @@ -3937,9 +3936,9 @@ } }, "liquidjs": { - "version": "10.20.2", - "resolved": "https://registry.npmjs.org/liquidjs/-/liquidjs-10.20.2.tgz", - "integrity": "sha512-MbAueOtO8aH+GzC/kmhcJTiMrMu+MVel/3+yhFVmP3K89WP0ZuvVPi8ZRKCHAO6SLJvV0Y0Jz6tUEy6Hg8xO/g==", + "version": "10.25.0", + "resolved": "https://registry.npmjs.org/liquidjs/-/liquidjs-10.25.0.tgz", + "integrity": "sha512-XpO7AiGULTG4xcTlwkcTI5JreFG7b6esLCLp+aUSh7YuQErJZEoUXre9u9rbdb0057pfWG4l0VursvLd5Q/eAw==", "requires": { "commander": "^10.0.0" }