Total Cookie Protection and website breakage FAQ

Enhanced Tracking Protection in Firefox automatically protects your privacy while you browse. It blocks cookies and trackers that follow you around online to collect information about your browsing habits and interests. Enabling Total Cookie Protection within Enhanced Tracking Protection will block third-party cookies to prevent tracking companies from tracking your browsing from site to site. However, this may cause some websites not to work correctly, which is referred to as site breakage.

The following FAQs can help you understand how cookies work, how Mozilla helps protect your privacy, and how to identify if a website isn’t working correctly due to Total Cookie Protection.

What is a cookie?

Cookies are small files that collect information about your activity on websites you visit. They often store your login information and your preferred language or location. When you return to a website you’ve previously visited, cookies store your login information and preferences. Cookies also store other information that can be used to identify you and track your online activity.

What are third-party cookies?

Third-party cookies are cookies set by a website other than the one you are currently on and that are stored on your computer. Third-party cookies can track you across websites to learn from your online activity to personalize your content based on preferences.

What is Enhanced Tracking Protection?

Enhanced Tracking Protection is a Firefox feature that blocks trackers that follow you around online to collect information about your browsing habits and interests.

What is Total Cookie Protection?

Total Cookie Protection is an advancement built into Enhanced Tracking Protection that works by maintaining a separate “cookie jar” for each website you visit. Any time a website, or third-party content embedded in a website, deposits a cookie in your browser, that cookie is confined to the cookie jar assigned to that website, such that it is not allowed to be shared with any other website.

TCPFx86

Total Cookie Protection is enabled by default in Firefox to all users worldwide. To learn more, see this Mozilla Blog post.

What is the difference between Enhanced Tracking Protection and Total Cookie Protection?

Enhanced Tracking Protection blocks cookies from companies that have been identified as trackers. Total Cookie Protection is an additional privacy protection built into Enhanced Tracking Protection. Total Cookie Protection provides more comprehensive protections against cookie-based tracking to ensure that no cookies can be used to track you from site to site as you browse the web.

ETPsettings

How do I access the Enhanced Tracking Protection settings?

To access the Enhanced Tracking Protection settings, follow the steps below:

  1. In the Menu bar at the top of the screen, click Firefox and then select Preferences or Settings, depending on your macOS version.Click the menu button Fx89menuButton and select Settings.
  2. Click on the Privacy & Security panel to the left side of the screen.

Why does Total Cookie Protection cause site breakage?

Total Cookie Protection divides a website's third-party storage into different partitions in order to isolate cookies, so they can't track you across websites. When this happens, sites can break because website developers don't expect third-party storage to be split in this way. The breakage occurs when the first-party website tries to retrieve information from the third-party storage that has been partitioned.

What kind of breakages does Total Cookie Protection cause?

Breakage caused by Total Cookie Protection appears in three forms:

  • An error message: When a website identifies a problem with a third-party iframe, an error message is frequently displayed to warn the user of the problem.
  • Site breakage after login: Even if the site login works, certain website functionality may be broken.
  • Unsuccessful login: The site's login process is never completed. It will return to the logged-out status and prompt users to log in again.

How do I know if the site breakage is caused by Total Cookie Protection?

Total Cookie Protection is not the only feature of Firefox that can break a website. Frequently, the website's failure has nothing to do with Total Cookie Protection. Therefore, we need to make sure that Total Cookie Protection is actually breaking the site before reporting the problem to the support staff.

  • Disable Enhanced Tracking Protection by clicking the toggle in the shield panel next to the address bar, and then test the breakage. If this fixes the problem, it’s a Total Cookie Protection-related issue.
  • Advanced users can visit the about:config page and check if the preference network.cookie.cookieBehavior is set to 4 or 5. Changing the preference value to 4 will disable Total Cookie Protection while still blocking Cross-Site Tracking Cookies (third party cookies from known tracking servers). If this fixes the breakage, it’s a Total Cookie Protection-related issue.
    Warning: Changing advanced preferences can affect Firefox's stability and security. This is recommended for advanced users only.

Can I disable Total Cookie Protection without disabling Enhanced Tracking Protection?

Yes. To disable Total Cookie Protection follow these steps:

  1. Select the Custom setting under your Enhanced Tracking Protection settings.
  2. Set the drop-down menu next to Cookies to Cross-Site Tracking Cookies.

This will disable Total Cookie Protection but keep Enhanced Tracking Protection enabled.

If I disable Total Cookie Protection to fix the breakage, will third-party cookies be able to track me?

Disabling Total Cookie Protection will make it easier for sites to track you. But Enhanced Tracking Protection will still provide some baseline protection in standard mode.

A website asked me to disable cookie protections to work correctly. Is this safe?

If users disable the protections, they will effectively allow sites to track them. Therefore, if you still want to visit the site, you should disable Enhanced Tracking Protection for that specific site only.

How do I report site breakage caused by Total Cookie Protection?

Once you’ve confirmed that Total Cookie Protection causes the issue, you can report it to the AntiTracking Engineering team.

Open an AntiTracking Bugzilla Bug
Opening a bug on Bugzilla using our bug template helps us diagnose the issue more quickly. Please provide detailed information regarding the breakage, such as a screenshot of the breakage or clear steps to reproduce the issue. You can also provide troubleshooting information from the about:support page. This helps us to reproduce the problem locally.

Was this article helpful?

Please wait...

These fine people helped write this article:

Illustration of hands

Volunteer

Grow and share your expertise with others. Answer questions and improve our knowledge base.

Learn More