Cookies and user identification

Google tags use cookies to identify unique users across browsing sessions. Cookies are a small file saved on people's computers to help store preferences and other information that's used on webpages that they visit.

Google uses cookies in various ways. For example, remarketing and Google Analytics both use cookies to help do things like run your ads or measure your success.

The conversion measurement features of Google Ads and Campaign Manager also uses cookies. To help you measure sales and other conversions from your ad, it adds a cookie to a person's computer when the person clicks an ad.

This page explains how to customize cookie settings with global site tags and Google Tag Manager. Refer to the advertising and measurement cookie reference for a detailed list of cookies used by Google.

Note: If you use a global site tag implementation and you have multiple products on a page that share cookies, use gtag('set') commands instead of gtag('config') for your cookie configuration settings. Doing so will give you more consistent results.

Caution: In most cases, the default cookie preferences should not be modified, and you should only make changes to these settings if your application requires it.

Cookie domain configuration

By default, Google tags use automatic cookie domain configuration. Cookies are set on the highest level of domain possible. For example, if your website address is blog.example.com, cookies are set on the example.com domain. If it is detected that you're running a server locally (e.g. localhost), cookie_domain is automatically set to 'none', and cookies will use the full domain from the document location.

To make changes to the cookie domain configuration, follow these steps:

gtag.js

To turn off automatic cookie domain configuration, update the config for your tag to specify a value for the cookie_domain parameter:

gtag('config', 'G-XXXXXX', {
  'cookie_domain': 'blog.example.com'
});

Tag Manager

For Google Analytics tags:

1. In Tag Manager, navigate to Fields to Set:
   • For Google Analytics 4 Configuration tags, select Tag Configuration > Fields to Set.
   • For Universal Analytics tags, use a Google Analytics settings variable and select Variable Configuration > More Settings > Fields to Set.
2. When the Fields to Set section is expanded, click Add Row.
3. For Field Name, enter the correct value:
   • For Google Analytics 4 Configuration tags, enter cookie_domain.
   • For Universal Analytics Google Analytics settings variables, enter cookieDomain.
4. For Value, enter the domain value, e.g. my.example.com.
5. Save the tag and publish.

For Google Ads and Floodlight tags:

Domain settings can be modified from the Conversion Linker tag:

1. In Tag Manager, open your existing Conversion Linker tag, or create one if the tag doesn't yet exist in your container.
2. Under Linker Options, click Override cookie settings (advanced)
3. In the Domain field, enter the highest level domain for which a cookie should be allowed to be set. You can also specify a specific path in the Path field. Only use these settings if you need to limit cookies to a lower-level subdomain or subdirectory.

Note: When you use automatic cookie domain configuration, activity will be measured across subdomains without any extra configuration.

Important: The cookie_domain value must be an ancestor of the current domain, otherwise the cookie will not be set. For example, if your domain is one.two.three.root.com, you may configure the cookie to be set on root.com, but not someotherdomain.com. Setting an incorrect cookie domain may result in no data being sent.

Rename cookies

To avoid conflicts with other cookies, you may need to change the cookie name.

gtag.js

This configuration will add example to the beginning of the cookie that it sets (e.g. _ga becomes example_ga, or _gcl_au becomes example_gcl_au):

gtag('config', 'G-XXXXXX', {
  cookie_prefix: 'example'
});

Tag Manager

For Google Analytics 4 Configuration tags:

1. In Google Tag Manager, open a Google Analytics 4 Configuration tag and click Tag Configuration > Fields to Set.
2. When the Fields to Set section is expanded, click Add Row.
3. For Field Name, enter cookie_prefix.
4. For Value, enter the prefix value, e.g. example.
5. Save the tag and publish.

For Universal Analytics tags:

Universal Analytics tags in Tag Manager can replace the name of the cookie with cookieName via a Google Analytics settings variable.

1. In Tag Manager, open a Google Analytics settings variable and select Variable Configuration > More Settings > Fields to Set.
2. When the Fields to Set section is expanded, click Add Row.
3. For Field Name, enter enter cookieName.
4. For Value, enter the name of the cookie, e.g. myCookie.
5. Save the tag and publish.

Note: The Universal Analytics tag template in Tag Manager changes the entire name of the cookie. This behavior is distinct from the Google Analytics 4 Configuration tag template in Tag Manager and the global site tag's cookie_prefix property, which both add text to the beginning of the default cookie name.

For Google Ads and Floodlight tags:

Name prefix settings can be modified from the Conversion Linker tag:

1. In Tag Manager, open your existing Conversion Linker tag, or create one if the tag doesn't yet exist in your container.
2. Under Linker Options, click Override cookie settings (advanced)
3. In the Name prefix field, enter the desired name prefix. Any tags that use these cookies (e.g. Google Ads conversion tags) must also be configured to use the same prefix.

Important: If the cookie name settings change after users have first visited your site, those visitors will appear as new visitors because the context stored in the non-modified cookies will be lost.

Cookie expiration

On each page load, the cookie expiration time is updated to be the current time plus the cookie expiration value set by the Google tag. This means that if cookie expiration is set to one week (604800 seconds), and a user visits using the same browser within five days, the cookie will be available for an additional week, and they will appear as the same visitor in your reports. If that same user instead visited after the original cookie had expired, a new cookie will be created, and their first and second visits will appear as coming from distinct visitors in your reports.

If you set the cookie expiration value to 0 (zero) seconds, the cookie turns into a session based cookie and expires once the current browser session ends.

gtag.js

gtag('config', 'G-XXXXXX', {
  cookie_expires: 28 * 24 * 60 * 60 // 28 days, in seconds
});

Tag Manager

For Google Analytics tags:

1. In Tag Manager, navigate to Fields to Set:
   • For Google Analytics 4 Configuration tags, select Tag Configuration > Fields to Set.
   • For Universal Analytics tags, use a Google Analytics settings variable and select Variable Configuration > More Settings > Fields to Set.
2. When the Fields to Set section is expanded, click Add Row.
3. For Field Name, enter the correct value:
   • For Google Analytics 4 Configuration tags, enter cookie_expires.
   • For Universal Analytics Google Analytics settings variables, enter cookieExpires.
4. For Value, enter the number of seconds before the cookie will expire, e.g. for 28 days, enter 2419200.
5. Save the tag and publish.

Note: Google Ads and Floodlight cookies set by the Conversion Linker tag do not support cookie_expires at this time. If support for cookie_expires is required, use gtag.js for this tag configuration.

Cookie update

When the cookie_update flag is set to true (the default value), Google tags may update cookies on each page load, and may update the cookie expiration to be set relative to the most recent visit to the site. For example, if cookie expiration is set to one week, and a user visits using the same browser every five days, the cookie expiration will be updated on each visit and so will effectively never expire.

When set to false, cookies are not updated on each page load. This has the effect of cookie expiration being relative to the first time a user visited the site.

gtag.js

gtag('config', 'G-XXXXXX', {
  cookie_update: false
});

Tag Manager

For Google Analytics tags:

1. In Tag Manager, navigate to Fields to Set:
   • For Google Analytics 4 Configuration tags, select Tag Configuration > Fields to Set.
   • For Universal Analytics tags, use a Google Analytics settings variable and select Variable Configuration > More Settings > Fields to Set.
2. When the Fields to Set section is expanded, click Add Row.
3. For Field Name, enter the correct value:
   • For Google Analytics 4 Configuration tags, enter cookie_update.
   • For Universal Analytics Google Analytics settings variables, enter cookieUpdate.
4. For Value, enter a boolean value, e.g. false.
5. Save the tag and publish.

Note: Google Ads and Floodlight cookies set by the Conversion Linker tag do not support cookie_update at this time. If support for cookie_update is required, use gtag.js for this tag configuration.