caption: Override Related Website Sets.
deprecated: true
default: {}
desc: |-
  This policy provides a way to override the list of sets the browser uses for Related Website Sets features.

  This policy overrides the <ph name="FIRST_PARTY_SETS_OVERRIDES_POLICY_NAME">FirstPartySetsOverrides</ph> policy.

  Each set in the browser's list of Related Website Sets must meet the requirements of a Related Website Set.
  A Related Website Set must contain a primary site and one or more member sites.
  A set can also contain a list of service sites that it owns, as well as a map from a site to all of its ccTLD variants.
  See https://github.com/WICG/first-party-sets for more information on how <ph name="PRODUCT_NAME">$1<ex>Google Chrome</ex></ph> uses Related Website Sets.


  All sites in a Related Website Set must be a registrable domain served over HTTPS. Each site in a Related Website Set must also be unique,
  meaning a site cannot be listed more than once in a Related Website Set.

  When this policy is given an empty dictionary, the browser uses the public list of Related Website Sets.

  For all sites in a Related Website Set from the <ph name="REPLACEMENTS">replacements</ph> list, if a site is also present
  on a Related Website Set in the browser's list, then that site will be removed from the browser's Related Website Set.
  After this, the policy's Related Website Set will be added to the browser's list of Related Website Sets.

  For all sites in a Related Website Set from the <ph name="ADDITIONS">additions</ph> list, if a site is also present
  on a Related Website Set in the browser's list, then the browser's Related Website Set will be updated so that the
  new Related Website Set can be added to the browser's list. After the browser's list has been updated,
  the policy's Related Website Set will be added to the browser's list of Related Website Sets.

  The browser's list of Related Website Sets requires that for all sites in its list, no site is in
  more than one set. This is also required for both the <ph name="REPLACEMENTS">replacements</ph> list
  and the <ph name="ADDITIONS">additions</ph> list. Similarly, a site cannot be in both the
  <ph name="REPLACEMENTS">replacements</ph> list and the <ph name="ADDITIONS">additions</ph> list.

  Wildcards (*) are not supported as a policy value, nor within any Related Website Set in these lists.

  All sets provided by the policy must be valid Related Website Sets, if they aren't then an
  appropriate error will be outputted.

  On <ph name="MS_WIN_NAME">Microsoft® Windows®</ph>, this policy is only available on instances that are joined to a <ph name="MS_AD_NAME">Microsoft® Active Directory®</ph> domain, joined to <ph name="MS_AAD_NAME">Microsoft® Azure® Active Directory®</ph> or enrolled in <ph name="CHROME_ENTERPRISE_CORE_NAME">Chrome Enterprise Core</ph>.

  On <ph name="MAC_OS_NAME">macOS</ph>, this policy is only available on instances that are managed via MDM, joined to a domain via MCX or enrolled in <ph name="CHROME_ENTERPRISE_CORE_NAME">Chrome Enterprise Core</ph>.

  This policy is deprecated as of <ph name="PRODUCT_NAME">$1<ex>Google Chrome</ex></ph> version 144 with the deprecation of Related Website Sets.
example_value:
  additions:
  - associatedSites:
    - https://associate2.test
    ccTLDs:
      https://associate2.test:
      - https://associate2.com
    primary: https://primary2.test
    serviceSites:
    - https://associate2-content.test
  replacements:
  - associatedSites:
    - https://associate1.test
    ccTLDs:
      https://associate1.test:
      - https://associate1.co.uk
    primary: https://primary1.test
    serviceSites:
    - https://associate1-content.test
features:
  dynamic_refresh: false
  per_profile: true
supported_on:
- chrome.*:120-152
- chrome_os:120-152
- android:120-152
- fuchsia:120-152
owners:
- sandormajor@chromium.org
- chrome-first-party-sets@chromium.org
schema:
  properties:
    additions:
      items:
        properties:
          associatedSites:
            items:
              type: string
            type: array
          ccTLDs:
            additionalProperties:
              items:
                type: string
              type: array
            type: object
          primary:
            type: string
          serviceSites:
            items:
              type: string
            type: array
        required:
        - primary
        - associatedSites
        type: object
      type: array
    replacements:
      items:
        properties:
          associatedSites:
            items:
              type: string
            type: array
          ccTLDs:
            additionalProperties:
              items:
                type: string
              type: array
            type: object
          primary:
            type: string
          serviceSites:
            items:
              type: string
            type: array
        required:
        - primary
        - associatedSites
        type: object
      type: array
  type: object
tags: []
type: dict
