diff --git a/config/config.go b/config/config.go
index 31ebb288e..956e1c6c6 100644
--- a/config/config.go
+++ b/config/config.go
@@ -489,8 +489,8 @@ type ScrapeConfig struct {
 	// More than this label value length post metric-relabeling will cause the
 	// scrape to fail.
 	LabelValueLengthLimit uint `yaml:"label_value_length_limit,omitempty"`
-	// More than this many buckets in a native histogram will cause the scrape to
-	// fail.
+	// More than this many buckets in a native histogram will cause the histogram
+	// to be ignored, but it will not make the whole scrape fail.
 	NativeHistogramBucketLimit uint `yaml:"bucket_limit,omitempty"`
 
 	// We cannot do proper Go type embedding below as the parser will then parse
diff --git a/docs/configuration/configuration.md b/docs/configuration/configuration.md
index f27f8256a..f51227320 100644
--- a/docs/configuration/configuration.md
+++ b/docs/configuration/configuration.md
@@ -376,6 +376,11 @@ metric_relabel_configs:
 # 0 means no limit. This is an experimental feature, this behaviour could
 # change in the future.
 [ target_limit: <int> | default = 0 ]
+
+# Limit on total number of positive and negative buckets allowed in a native
+# histogram. If this is exceeded, the histogram will be ignored, but this will
+# not make the scrape fail. 0 means no limit.
+[ sample_limit: <int> | default = 0 ]
 ```
 
 Where `<job_name>` must be unique across all scrape configurations.