diff --git a/docs/settings/apm-settings.asciidoc b/docs/settings/apm-settings.asciidoc
index 8112f7310375d..7e7e1aa370bb8 100644
--- a/docs/settings/apm-settings.asciidoc
+++ b/docs/settings/apm-settings.asciidoc
@@ -43,45 +43,41 @@ If you'd like to change any of the default values,
 copy and paste the relevant settings into your `kibana.yml` configuration file.
 Changing these settings may disable features of the APM App.
 
-[cols="2*<"]
-|===
-| `xpack.apm.enabled`
-  | Set to `false` to disable the APM app. Defaults to `true`.
+`xpack.apm.enabled`::
+Set to `false` to disable the APM app. Defaults to `true`.
 
-| `xpack.apm.ui.enabled` {ess-icon}
-  | Set to `false` to hide the APM app from the menu. Defaults to `true`.
+`xpack.apm.ui.enabled`{ess-icon}::
+Set to `false` to hide the APM app from the menu. Defaults to `true`.
 
-| `xpack.apm.ui.transactionGroupBucketSize`
-  | Number of top transaction groups displayed in the APM app. Defaults to `100`.
+`xpack.apm.ui.transactionGroupBucketSize` {ess-icon}::
+Number of top transaction groups displayed in the APM app. Defaults to `1000`.
 
-| `xpack.apm.ui.maxTraceItems` {ess-icon}
-  | Maximum number of child items displayed when viewing trace details. Defaults to `1000`.
+`xpack.apm.ui.maxTraceItems` {ess-icon}::
+Maximum number of child items displayed when viewing trace details. Defaults to `1000`.
 
-| `xpack.observability.annotations.index`
-  | Index name where Observability annotations are stored. Defaults to `observability-annotations`.
+`xpack.observability.annotations.index` {ess-icon}::
+Index name where Observability annotations are stored. Defaults to `observability-annotations`.
 
-| `apm_oss.indexPattern` {ess-icon}
-  | The index pattern used for integrations with Machine Learning and Query Bar.
-  It must match all apm indices. Defaults to `apm-*`.
+`apm_oss.indexPattern` {ess-icon}::
+The index pattern used for integrations with Machine Learning and Query Bar.
+It must match all apm indices. Defaults to `apm-*`.
 
-| `apm_oss.errorIndices` {ess-icon}
-  | Matcher for all {apm-server-ref}/error-indices.html[error indices]. Defaults to `apm-*`.
+`apm_oss.errorIndices` {ess-icon}::
+Matcher for all {apm-server-ref}/error-indices.html[error indices]. Defaults to `apm-*`.
 
-| `apm_oss.onboardingIndices`
-  | Matcher for all onboarding indices. Defaults to `apm-*`.
+`apm_oss.onboardingIndices`::
+Matcher for all onboarding indices. Defaults to `apm-*`.
 
-| `apm_oss.spanIndices` {ess-icon}
-  | Matcher for all {apm-server-ref}/span-indices.html[span indices]. Defaults to `apm-*`.
+`apm_oss.spanIndices` {ess-icon}::
+Matcher for all {apm-server-ref}/span-indices.html[span indices]. Defaults to `apm-*`.
 
-| `apm_oss.transactionIndices` {ess-icon}
-  | Matcher for all {apm-server-ref}/transaction-indices.html[transaction indices]. Defaults to `apm-*`.
+`apm_oss.transactionIndices` {ess-icon}::
+Matcher for all {apm-server-ref}/transaction-indices.html[transaction indices]. Defaults to `apm-*`.
 
-| `apm_oss.metricsIndices`
-  | Matcher for all {apm-server-ref}/metricset-indices.html[metrics indices]. Defaults to `apm-*`.
+`apm_oss.metricsIndices`::
+Matcher for all {apm-server-ref}/metricset-indices.html[metrics indices]. Defaults to `apm-*`.
 
-| `apm_oss.sourcemapIndices`
-  | Matcher for all {apm-server-ref}/sourcemap-indices.html[source map indices]. Defaults to `apm-*`.
-
-|===
+`apm_oss.sourcemapIndices`::
+Matcher for all {apm-server-ref}/sourcemap-indices.html[source map indices]. Defaults to `apm-*`.
 
 // end::general-apm-settings[]