govuk_publishing_components 40.1.0 → 41.0.0

data/app/views/govuk_publishing_components/components/contextual_sidebar/_ukraine_cta.html.erb

@@ -2,8 +2,7 @@
   shared_helper = GovukPublishingComponents::Presenters::SharedHelper.new(local_assigns)
   title = t("components.related_navigation.ukraine.title")
   lang = shared_helper.t_locale("components.related_navigation.ukraine.title")
-  data_module = "gem-track-click"
-  data_module << " ga4-link-tracker" unless disable_ga4
+  data_module = "ga4-link-tracker" unless disable_ga4
 %>
 <%= tag.div class: "gem-c-contextual-sidebar__cta gem-c-contextual-sidebar__cta--ukraine", data: { module: data_module } do %>
   <%= tag.h2 title, class: "gem-c-contextual-sidebar__heading govuk-heading-s" %>
@@ -26,11 +25,6 @@
           link[:href],
           class: "govuk-link",
           data: {
-            "track-category": "relatedLinkClicked",
-            "track-action": "1.0 Invasion of Ukraine",
-            "track-label": link[:href],
-            "track-dimension": link[:label],
-            "track-dimension-index": "29",
             ga4_link: ga4_attributes,
           },
           lang: lang %>

data/app/views/govuk_publishing_components/components/docs/accordion.yml

@@ -199,16 +199,10 @@ examples:
     description: |
       Adds custom data attributes to each section of the accordion. Accepts a hash, so multiple attributes can be added.
 
-      The `data_attributes` option applies attributes to the outermost element in the accordion. Each item can also have a `data_attributes` hash, which are placed on the `button` that triggers the opening and closing - useful for differentiating between each section of the accordion.
-
-      Data attributes can be added to the 'Show/hide all' link using the `data_attributes_show_all` option, primarily where custom tracking is required. These attributes are read from the accordion markup and then added to the link by JavaScript (which is how the link is created). Currently, this is only used for tracking with Universal Analytics.
-
-      If `track_options` within `data_attributes_show_all` is set, then it is possible to pass a custom dimension when 'Show/Hide all' is clicked.
+      The `data_attributes` option applies attributes to the outermost element in the accordion. Individual items can also have their own `data_attributes` hash, which are placed on the `button` that triggers the opening and closing of that section - useful for differentiating between each section of the accordion.
     data:
       data_attributes:
         custom_data_attr: custom-data-attr-accordion
-      data_attributes_show_all:
-        tracking-options: "{ 'dimension114': 1 }"
       items:
         - heading:
             text: Writing well for the web
@@ -234,20 +228,6 @@ examples:
             html: <p class="govuk-body">This is the content for How people read.</p>
           data_attributes:
             custom_data_attr: custom-data-attr-accordion-item-4
-  with_custom_data_module:
-    description: The component includes its own `data-module` but others can be passed in addition if required, for example to apply tracking to an element. This will be included along with the components own `data-module`.
-    data:
-      data_attributes:
-        module: gem-track-click
-      items:
-        - heading:
-            text: Writing well for the web
-          content:
-            html: <p class="govuk-body">This is the content for Writing well for the web.</p>
-        - heading:
-            text: Writing well for specialists
-          content:
-            html: <p class="govuk-body">This is the content for Writing well for specialists.</p>
   different_heading_level:
     description: This will alter the level of the heading, not the appearance of the heading.
     data:
@@ -339,42 +319,3 @@ examples:
             text: How people read
           content:
             html: <p class="govuk-body">This is the content for How people read.</p>
-  with_track_show_all_clicks:
-    description: |
-      To switch on Google Analytics for the "Show all sections" button on click, pass `track_show_all_clicks: true` the values passed on open will be
-      `Event Action: accordionOpened` `Event Category: pageElementInteraction` `Event Label: Show all sections`
-    data:
-      track_show_all_clicks: true
-      items:
-        - heading:
-            text: Writing well for the web
-            id: writing-well-for-the-web-2
-          content:
-            html: <p class="govuk-body">This is content for accordion 1 of 2</p>
-        - heading:
-            text: Writing well for specialists
-          content:
-            html: <p class="govuk-body">This is content for accordion 2 of 2</p>
-  with_track_sections:
-    description: |
-      To switch on Google Analytics for each section, on click, pass `track_sections: true` the values passed on open will be
-      `Event Action: accordionOpened` / `accordionClosed` `Event Category: pageElementInteraction` and the `Event Label` being the heading text.
-
-      If `track_options` in an item is set, then it is possible to pass a custom dimension when the section is clicked.
-
-      (`track_show_all_clicks: true` can be added to track the "Show all sections" button as well, if required)
-    data:
-      track_sections: true
-      items:
-        - heading:
-            text: Writing well for the web
-            id: writing-well-for-the-web-3
-          content:
-            html: <p class="govuk-body">This is content for accordion 1 of 2</p><p class="govuk-body">This content contains a <a href="#anchor-nav-test" class="govuk-link">link</a></p>
-          data_attributes:
-            track_options:
-              dimension114: 1
-        - heading:
-            text: Writing well for specialists
-          content:
-            html: <p class="govuk-body" id="anchor-nav-test">This is content for accordion 2 of 2</p>

data/app/views/govuk_publishing_components/components/docs/big_number.yml

@@ -37,17 +37,13 @@ examples:
     description: |
       If a `href` attribute is present, `data_attributes` will apply to the `span` containing the number value (see below).
 
-      Note that the component does not include built in tracking. If this is required consider using the [track click script](https://github.com/alphagov/govuk_publishing_components/blob/main/docs/analytics/track-click.md).
+      Note that the component does not include built in tracking. If this is required consider using the [GA4 link tracker](https://github.com/alphagov/govuk_publishing_components/blob/main/docs/analytics-ga4/trackers/ga4-link-tracker.md).
     data:
       number: 23
       label: Ministerial departments
       href: "/government/organisations#ministerial_departments"
       data_attributes:
-        track-category: homepageClicked
-        track-action: departmentsLink
-        track-label: "/government/organisations#ministerial_departments"
-        track-dimension: 23 Ministerial departments
-        track-dimension-index: 29
+        department-count: true
   with_data_attributes_but_no_link:
     data:
       number: 23

data/app/views/govuk_publishing_components/components/docs/breadcrumbs.yml

@@ -2,7 +2,6 @@ name: "Breadcrumbs"
 description: "Navigational breadcrumbs, showing page hierarchy"
 body: |
   Accepts an array of breadcrumb objects. Each crumb must have a title and a URL.
-  Links are tracked, but in Universal Analytics, links to the homepage (any link with a url of `/`) will be tracked separately as `homeLinkClicked`.
 
   We recommend that if using the breadcrumbs for navigation purposes, you set `collapse_on_mobile` to `true` to make things more readable for mobile users. However, you can specify `collapse_on_mobile:``false` or remove the flag completely to stop this behaviour.
 shared_accessibility_criteria:

data/app/views/govuk_publishing_components/components/docs/button.yml

@@ -97,7 +97,7 @@ examples:
       start: true
       href: '#'
   with_data_attributes:
-    description: Data attributes can be applied as required. Note that the component does not include built in tracking. If this is required consider using the [track click script](https://github.com/alphagov/govuk_publishing_components/blob/main/docs/analytics/track-click.md).
+    description: Data attributes can be applied as required. Note that the component does not include built in tracking. If this is required consider using the [GA4 link tracker](https://github.com/alphagov/govuk_publishing_components/blob/main/docs/analytics-ga4/trackers/ga4-link-tracker.md).
     data:
       text: Track this!
       margin_bottom: true

data/app/views/govuk_publishing_components/components/docs/cards.yml

@@ -121,28 +121,18 @@ examples:
     description: |
       Data attributes can be passed to individual links within the component as shown.
 
-      Note that the component does not include built in tracking. If this is required consider using the [track click script](https://github.com/alphagov/govuk_publishing_components/blob/main/docs/analytics/track-click.md).
+      Note that the component does not include built in tracking. If this is required consider using the [GA4 link tracker](https://github.com/alphagov/govuk_publishing_components/blob/main/docs/analytics-ga4/trackers/ga4-link-tracker.md).
     data:
       items:
         - link:
             text: Benefits
             path: http://www.gov.uk
             data_attributes:
-              track_category: homepageClicked
-              track_action: track-action
-              track_label: track-label
-              track_dimension: track-dimension
-              track_dimension_index: 29
-              track_value: 9
+              an_attribute: some_value
           description: Includes eligibility, appeals, tax credits and Universal Credit
         - link:
             text: Births, deaths, marriages and care
             path: http://www.gov.uk
             data_attributes:
-              track_category: homepageClicked
-              track_action: track-action
-              track_label: track-label
-              track_dimension: track-dimension
-              track_dimension_index: 29
-              track_value: 9
+              an_attribute: some_value
           description: Parenting, civil partnerships, divorce and Lasting Power of Attorney

data/app/views/govuk_publishing_components/components/docs/checkboxes.yml

@@ -200,39 +200,6 @@ examples:
           value: green
         - label: Blue
           value: blue
-  checkboxes_with_data_attributes:
-    description: Data attributes for tracking can be applied as shown. Custom JavaScript in the component will fire identical tracking events on check and uncheck. See below to send different events on uncheck.
-    data:
-      name: With tracking
-      items:
-        - label: Tracked
-          value: tracked
-          data_attributes: {
-            track_category: checkboxClicked,
-            track_label: /news-and-communications,
-            track_action: news,
-            track_options: {
-              dimension28: 2,
-              dimension29: Tracked
-            }
-          }
-  checkboxes_with_data_attributes_and_custom_uncheck_event_category:
-    description: Data attributes for tracking can be applied as shown. Custom JavaScript in the component will fire different tracking events on check and uncheck.
-    data:
-      name: With tracking and a custom uncheck category
-      items:
-        - label: Tracked
-          value: tracked
-          data_attributes: {
-            track_category: checkboxClicked,
-            untrack_category: checkboxUnchecked,
-            track_label: /news-and-communications,
-            track_action: news,
-            track_options: {
-              dimension28: 2,
-              dimension29: Tracked
-            }
-          }
   with_aria_controls_attributes:
     description: Aria controls attributes are applied to the checkboxes only if JavaScript is enabled.
     data:

data/app/views/govuk_publishing_components/components/docs/cookie_banner.yml

@@ -41,11 +41,11 @@ examples:
         "yes":
           text: "Yes"
           data_attributes:
-            track-category: cookieBanner
+            an_attribute: some_value1
         "no":
           text: "No"
           data_attributes:
-            "track-category": "cookieBanner"
+            an_attribute: some_value2
         cookie_preferences:
           text: How we use cookies
           href: "/cookies"

data/app/views/govuk_publishing_components/components/docs/details.yml

@@ -21,21 +21,6 @@ examples:
       title: Help with nationality
       block: |
         We need to know your nationality so we can work out which elections you’re entitled to vote in. If you can’t provide your nationality, you’ll have to send copies of identity documents through the post.
-  with_data_attributes:
-    description: |
-      Data attributes can be applied to the summary element of the component.
-
-      This can be used for tracking as shown. Custom JavaScript in the component fires tracking events when the details element is opened and closed. By default, `track-label` is set to the status (`open` or `closed`) unless a `track_label` is passed into the component.
-    data:
-      title: Help with nationality
-      data_attributes:
-        track_category: "checker-qa"
-        track_action: "business-question"
-        track_label: "custom label here"
-        track_options:
-          dimension20: "custom dimension"
-      block: |
-        We need to know your nationality so we can work out which elections you’re entitled to vote in. If you can’t provide your nationality, you’ll have to send copies of identity documents through the post.
   with_aria_attributes:
     description: |
       Aria attributes can be applied to the summary element of the component.

data/app/views/govuk_publishing_components/components/docs/document_list.yml

@@ -75,19 +75,17 @@ examples:
           public_updated_at: 2016-09-05 16:48:27
           document_type: 'Statutory guidance'
   with_data_attributes_on_links:
-    description: Note that the component does not include built in Universal Analytics tracking. If this is required consider using the [track click script](https://github.com/alphagov/govuk_publishing_components/blob/main/docs/analytics/track-click.md).
     data:
       items:
       - link:
           text: 'School behaviour and attendance: parental responsibility measures'
           path: '/government/publications/parental-responsibility-measures-for-behaviour-and-attendance'
           data_attributes:
-            track_category: 'navDocumentCollectionLinkClicked'
-            track_action: 1.1
-            track_label: '/government/publications/parental-responsibility-measures-for-behaviour-and-attendance'
-            track_options:
-              dimension28: 2
-              dimension29: 'School behaviour and attendance: parental responsibility measures'
+            a_thing: 'hello'
+            another_thing: 'there'
+            more_things:
+              look: 'over'
+              there: 'now'
         metadata:
           public_updated_at: 2017-01-05 14:50:33
           document_type: 'Statutory guidance'
@@ -95,12 +93,11 @@ examples:
           text: 'School exclusion'
           path: '/government/publications/school-exclusion'
           data_attributes:
-            track_category: 'navDocumentCollectionLinkClicked'
-            track_action: 1.2
-            track_label: '/government/publications/school-exclusion'
-            track_options:
-              dimension28: 2
-              dimension29: 'School exclusion'
+            a_thing: 'hello'
+            another_thing: 'there'
+            more_things:
+              look: 'over'
+              there: 'now'
         metadata:
           public_updated_at: 2017-07-19 15:01:48
           document_type: 'Statutory guidance'
@@ -306,11 +303,7 @@ examples:
             path: '/universal-credit/eligibility'
             description: 'You may be able to get Universal Credit if: you’re on a low income or out...'
             data_attributes:
-              track_category: 'resultPart'
-              track_action: 2
-              track_label: 'Result part 2'
-              track_options:
-                dimension82: 2
+              an_attribute: some_value
         - link:
             text: 'Criteria'
             description: 'no url provided, just text'

data/app/views/govuk_publishing_components/components/docs/error_alert.yml

@@ -25,7 +25,7 @@ examples:
     description: |
       The example shown applies a tracking attribute specifically for use by Google Tag Manager in [Content Publisher](https://github.com/alphagov/content-publisher).
 
-      Other data attributes can also be applied as required. Note that the component does not include built in tracking. If this is required consider using the [track click script](https://github.com/alphagov/govuk_publishing_components/blob/main/docs/analytics/track-click.md).
+      Other data attributes can also be applied as required. Note that the component does not include built in tracking. If this is required consider using the [GA4 link tracker](https://github.com/alphagov/govuk_publishing_components/blob/main/docs/analytics-ga4/trackers/ga4-link-tracker.md).
     data:
       message: Message to alert the user to a unsuccessful action goes here
       description: A further description

data/app/views/govuk_publishing_components/components/docs/govspeak.yml

@@ -504,17 +504,6 @@ examples:
       block: |
         <p>This content has a YouTube livestream link, converted to an accessible embedded player by component JavaScript.</p>
         <p><a href="https://www.youtube.com/embed/live_stream?channel=UCoMdktPbSTixAyNGwb-UYkQ">Livestream video</a></p>
-  with_youtube_analytics:
-    data:
-      block: |
-        <p>This content has a YouTube link with analytics, converted to an accessible embedded player by component JavaScript.</p>
-        <p>
-          <a href="https://www.youtube.com/watch?v=ucjmWjJ25Ho"
-            data-youtube-player-analytics="true"
-            data-youtube-player-analytics-category="demo-for-components">
-            Youtube video with tracking
-          </a>
-        </p>
   with_youtube_embed_disabled:
     data:
       disable_youtube_expansions: true

data/app/views/govuk_publishing_components/components/docs/image_card.yml

@@ -246,37 +246,6 @@ examples:
       <div class="govuk-!-width-full">
         <%= component %>
       </div>
-  with_data_attributes:
-    description: Data attributes can be applied as required. Note that the component does not include built in tracking. If this is required consider using the [track click script](https://github.com/alphagov/govuk_publishing_components/blob/main/docs/analytics/track-click.md).
-    data:
-      href: "/i-am-not-a-valid-link"
-      href_data_attributes: {
-        track_category: 'href_category',
-        track_action: 1.1,
-        track_label: 'href_label',
-        track_options: {
-          dimension28: 1,
-          dimension29: 'dimension29Href'
-        }
-      }
-      image_src: "https://assets.publishing.service.gov.uk/government/uploads/system/uploads/feature/image/62756/s300_courts-of-justice.JPG"
-      image_alt: "some meaningful alt text please"
-      heading_text: "A link with tracking"
-      extra_details: [
-        {
-          text: "Another link with tracking",
-          href: "/1",
-          data_attributes: {
-            track_category: 'extra_category',
-            track_action: 2.1,
-            track_label: 'extra_label',
-            track_options: {
-              dimension28: 1,
-              dimension29: 'dimension29Extra'
-            }
-          }
-        }
-      ]
   with_ga4_tracking:
     description: The component does not include an option for GA4 tracking, but data attributes to enable the [GA4 link tracker](https://github.com/alphagov/govuk_publishing_components/blob/main/docs/analytics-ga4/ga4-link-tracker.md) can be passed as shown.
     data:

data/app/views/govuk_publishing_components/components/docs/intervention.yml

@@ -63,32 +63,6 @@ examples:
       suggestion_link_url: www.google.com/permit
       new_tab: true
 
-  with_data_attributes:
-    description: |
-      This example shows the use of `suggestion_data_attributes`,
-      `dismiss_data_attributes` for click tracking on the dismiss section <p> tag, and `dismiss_link_data_attributes` for adding attributes to the dismiss link <a> tag.
-
-      Other data attributes can also be applied as required. Note that the component does not include built in tracking. If this is required consider using the [track click script](https://github.com/alphagov/govuk_publishing_components/blob/main/docs/analytics/track-click.md).
-    data:
-      suggestion_text: Based on your browsing you might be interested in
-      suggestion_link_text: "Travel abroad: step by step"
-      suggestion_link_url: /travel-abroad
-      suggestion_data_attributes:
-        track-category: interventionBanner
-        track-action: interventionClicked
-        track-dimension: "Travel abroad: step by step"
-        track-dimension-index: 29
-        track-label: clicked suggestion
-      dismiss_text: Hide this suggestion
-      name: another-campaign-name
-      dismiss_data_attributes:
-        track-category: interventionBanner
-        track-action: interventionDismissed
-        track-dimension: Hide this suggestion
-        track-dimension-index: 29
-        track-label: hide the intervention
-      dismiss_link_data_attributes:
-        track-category: example
   without_ga4_tracking:
     description: |
       Disables GA4 tracking on the banner. Tracking is enabled by default. This includes link tracking on the component itself, event tracking on the 'Hide' link, and allows pageviews to record the presence of the banner on page load.

data/app/views/govuk_publishing_components/components/docs/layout_for_public.yml

@@ -115,11 +115,11 @@ examples:
           yes:
             text: Yes
             data_attributes:
-              track_category: cookieBanner
+              an_attribute: some_value1
           no:
             text: No
             data_attributes:
-              track-category: cookieBanner
+              an_attribute: some_value2
           cookie_preferences:
             text: How GOV.UK accounts use cookies
             href: https://www.gov.uk/government/publications/govuk-accounts-trial-full-privacy-notice-and-accessibility-statement

data/app/views/govuk_publishing_components/components/docs/meta_tags.yml

@@ -5,8 +5,6 @@ body: |
   the correct analytics identifier metadata tags.
 
   These are additionally used by the <a href="https://github.com/alphagov/govuk-browser-extension">GOV.UK browser extension</a> to provide details about a given page.
-
-  The code which reads the meta tags can be found <a href="https://github.com/alphagov/govuk_publishing_components/blob/main/app/assets/javascripts/govuk_publishing_components/analytics/custom-dimensions.js">in custom-dimensions.js</a>.
 accessibility_criteria: |
   The analytics meta tags component should not be visible to any users.
 display_html: true

data/app/views/govuk_publishing_components/components/docs/option_select.yml

@@ -123,7 +123,7 @@ examples:
       - value: sombrero
         label: Sombrero
         id: sombrero
-  with_tracking:
+  with_data_attributes_on_checkboxes:
     data:
       key: list_of_shoes
       title: List of shoes
@@ -133,29 +133,17 @@ examples:
         label: Trainers
         id: trainers
         data_attributes:
-          track_category: "filterClicked"
-          track_action: "List of shoes"
-          track_label: "trainers"
-          track_options:
-            dimension28: 1
+          an_attribute: some_value1
       - value: plimsolls
         label: Plimsolls
         id: plimsolls
         data_attributes:
-          track_category: "filterClicked"
-          track_action: "List of shoes"
-          track_label: "plimsolls"
-          track_options:
-            dimension28: 1
+          an_attribute: some_value2
       - value: high_heels
         label: High heels
         id: high_heels
         data_attributes:
-          track_category: "filterClicked"
-          track_action: "List of shoes"
-          track_label: "high_heels"
-          track_options:
-            dimension28: 1
+          an_attribute: some_value3
   with_button_data_attributes:
     description: Allows data attributes to be passed to the component to be added to the expand/collapse button. The attributes are written to the parent element then read by the JavaScript and applied to the button. This is used for tracking purposes.
     data:

data/app/views/govuk_publishing_components/components/docs/organisation_logo.yml

@@ -151,21 +151,6 @@ examples:
         image:
           url: 'https://assets.publishing.service.gov.uk/government/uploads/system/uploads/organisation/logo/321/HMPS.jpg'
           alt_text: 'HM Prison Service'
-  with_data_attributes:
-    description: Data attributes can be applied as required. Note that the component does not include built in tracking. If this is required consider using the [track click script](https://github.com/alphagov/govuk_publishing_components/blob/main/docs/analytics/track-click.md).
-    data:
-      organisation:
-        name: Cabinet Office
-        url: '/government/organisations/cabinet-office'
-        brand: cabinet-office
-        crest: 'single-identity'
-        data_attributes:
-          track_category: "navOrganisationLinkClicked"
-          track_action: 1
-          track_label: '/government/organisations/cabinet-office'
-          track_options:
-            dimension28: 2
-            dimension29: Cabinet Office
   without_a_link:
     data:
       organisation:

data/app/views/govuk_publishing_components/components/docs/print_link.yml

@@ -20,17 +20,10 @@ examples:
     description: |
       Data attributes can be passed to the component as shown.
 
-      Note that the component does not include built in tracking. If this is required consider using the [track click script](https://github.com/alphagov/govuk_publishing_components/blob/main/docs/analytics/track-click.md).
+      Note that the component does not include built in tracking. If this is required consider using the [GA4 link tracker](https://github.com/alphagov/govuk_publishing_components/blob/main/docs/analytics-ga4/trackers/ga4-link-tracker.md).
     data:
       data_attributes:
-        track-category: "printButton"
-        track-action: "clicked"
-        track-label: "Print this page"
-  with_custom_data_module:
-    description: The component includes its own `data-module` but others can be passed in addition if required, for example to apply tracking to an element. This will be included along with the components own `data-module`.
-    data:
-      data_attributes:
-        module: "gem-track-click"
+        an_attribute: some_value
   with_custom_margins:
     description: The component accepts a number for margin bottom from `0` to `9` (`0px` to `60px`) using the [GOV.UK Frontend spacing scale](https://design-system.service.gov.uk/styles/spacing/#the-responsive-spacing-scale). It defaults to having margin level `3` on top and bottom.
     data:

data/app/views/govuk_publishing_components/components/docs/select.yml

@@ -54,42 +54,6 @@ examples:
         value: option1
       - text: Something else
         value: option2
-  with_tracking:
-    description: |
-      Tracking can be enabled on the select component by passing a minimum of `data_track_category` and `data_track_action`. Other tracking attributes are optional. Tracking is provided by the [track-select-change](https://github.com/alphagov/govuk_publishing_components/blob/main/app/assets/javascripts/govuk_publishing_components/analytics/track-select-change.js) module.
-
-      Note: tracking events do not fire within the component guide.
-    data:
-      id: dropdown3
-      label: With tracking enabled
-      options:
-      - text: Option one
-        value: option1
-        data_attributes:
-          track_category: relatedLinkClicked
-          track_action: 1.1
-          track_label: /link-1
-          track_options:
-            dimension28: 1
-            dimension29: Link 1
-      - text: Option two
-        value: option2
-        data_attributes:
-          track_category: relatedLinkClicked
-          track_action: 1.2
-          track_label: /link-2
-          track_options:
-            dimension28: 2
-            dimension29: Link 2
-      - text: Option three
-        value: option3
-        data_attributes:
-          track_category: relatedLinkClicked
-          track_action: 1.3
-          track_label: /link-3
-          track_options:
-            dimension28: 3
-            dimension29: Link 3
   with_data_attributes:
     description: Other data attributes can be passed to the component if needed.
     data:

data/app/views/govuk_publishing_components/components/docs/share_links.yml

@@ -47,7 +47,7 @@ examples:
     context:
       right_to_left: true
   with_data_attributes:
-    description: Data attributes can be added to both the parent element and the individual share links, as shown. Note that the component defaults to having a `data-module` of `gem-track-click`, but this is preserved even if another value for module is passed.
+    description: Data attributes can be added to both the parent element and the individual share links, as shown. Note that the component defaults to having a `data-module` of `ga4-link-tracker` if tracking is enabled, but this is preserved even if another value for module is passed.
     data:
       data_attributes:
         module: 'example-passed-module'
@@ -91,7 +91,7 @@ examples:
           hidden_text: '',
           icon: 'twitter'
         }
-      ]      
+      ]
   with_custom_visually_hidden_text:
     description: |
       Use this option to specify a visually hidden text for screenreaders to prepend to the link text.
@@ -108,8 +108,6 @@ examples:
       ]
   track_as_sharing_links:
     description: |
-      Where the component is used to allow users to share content on social media, tracking can be added that uses [Social Interactions](https://developers.google.com/analytics/devguides/collection/analyticsjs/social-interactions) in UA.
-      If this option is not included, it is assumed the component is simply linking to social media pages and the extra options are omitted from the tracking call in UA.
       In GA4, when this is set to true, a JSON is added to a data-attribute called data-ga4-link, which is detected by ga4-link-tracker.js and pushed to the dataLayer.
       Most of the tracking values are added by default, but if you need to add more GA4 values or override defaults, you can pass a ga4_extra_data object.
     data:

data/app/views/govuk_publishing_components/components/docs/step_by_step_nav.yml

@@ -122,29 +122,6 @@ examples:
           ]
         },
       ]
-  with_unique_tracking:
-    description: |
-      In order to identify the step by step navigation the component is part of, we need to track a unique ID of the navigation in Universal Analytics. This ID should be the same across all pages that are linked from and are part of that navigation. Its value is included in any tracking events, specifically in dimension96. It refers to the ID of the step nav page.
-
-      This includes show/hide all, show/hide step and any link clicks.
-    data:
-      tracking_id: 'this-is-the-tracking-id'
-      steps: [
-        {
-          title: 'Unique tracking id',
-          contents: [
-            {
-              type: 'list',
-              contents: [
-                {
-                  href: '#',
-                  text: 'This is a link'
-                }
-              ]
-            }
-          ]
-        }
-      ]
   with_a_different_heading_level:
     description: Steps have a `h2` by default, but this can be changed. The heading level does not change any styling.
     data:
@@ -573,8 +550,8 @@ examples:
     description: |
       Steps can be optional. This is controlled by two parameters, 'optional' and 'logic'.
 
-      - Optional steps used to have a dotted line down the side but this was removed as it confused users. In some cases we may still need to record if a step is optional, so if this parameter is applied, Google Analytics tracking events will have 'optional' appended to the end of the eventLabel.
-      - Logic will change the number next to a step to the word 'and' or the word 'or'.
+      - Optional steps used to have a dotted line down the side but this was removed as it confused users
+      - Logic will change the number next to a step to the word 'and' or the word 'or'
 
       If a step is optional this should be conveyed by the text within that step.
     data: