diff --git a/docs/resources.md b/docs/resources.md
index 0d785b08082..0e34c0c790a 100644
--- a/docs/resources.md
+++ b/docs/resources.md
@@ -933,7 +933,11 @@ service account.
 
 --------------------------------------------------------------------------------
 
-#### BuildGCS Storage Resource
+#### `Deprecated: `BuildGCS Storage Resource
+
+**NB:** This Resource type is _deprecated_, and will be removed in a future
+release. To fetch objects from Google Cloud Storage, prefer the [GCS storage
+resource](#gcs-storage-resource) instead.
 
 The `build-gcs` storage resource points to a
 [Google Cloud Storage](https://cloud.google.com/storage/) blob like
diff --git a/docs/variables.md b/docs/variables.md
index 84651369d7e..695da72caae 100644
--- a/docs/variables.md
+++ b/docs/variables.md
@@ -95,6 +95,9 @@ variable via `resources.inputs.<resourceName>.<variableName>` or
 
 #### Variables for the  `BuildGCS` type
 
+**NB:** This Resource type is **Deprecated**. See [BuildGCS Storage
+Resource](./resources.md#buildgcs-storage-resource) for more information.
+
 | Variable | Description |
 | -------- | ----------- |
 | `name` | The name of the resource. |
diff --git a/examples/v1alpha1/taskruns/build-gcs-targz.yaml b/examples/v1alpha1/taskruns/build-gcs-targz.yaml
index 6cc97602015..fc12a8b6df7 100644
--- a/examples/v1alpha1/taskruns/build-gcs-targz.yaml
+++ b/examples/v1alpha1/taskruns/build-gcs-targz.yaml
@@ -21,5 +21,7 @@ spec:
             value: gs://build-crd-tests/archive.tar.gz
           - name: artifactType
             value: TarGzArchive
+          # NB: The build-gcs PipelineResource type is deprecated, and will be
+          # removed in a future release.
           - name: type
             value: build-gcs
diff --git a/examples/v1alpha1/taskruns/build-gcs-zip.yaml b/examples/v1alpha1/taskruns/build-gcs-zip.yaml
index cabce951890..acb4e4dd2ce 100644
--- a/examples/v1alpha1/taskruns/build-gcs-zip.yaml
+++ b/examples/v1alpha1/taskruns/build-gcs-zip.yaml
@@ -21,5 +21,7 @@ spec:
             value: gs://build-crd-tests/archive.zip
           - name: artifactType
             value: ZipArchive
+          # NB: The build-gcs PipelineResource type is deprecated, and will be
+          # removed in a future release.
           - name: type
             value: build-gcs
diff --git a/examples/v1beta1/taskruns/build-gcs-targz.yaml b/examples/v1beta1/taskruns/build-gcs-targz.yaml
index f5a88edfce9..f8aa88d0b68 100644
--- a/examples/v1beta1/taskruns/build-gcs-targz.yaml
+++ b/examples/v1beta1/taskruns/build-gcs-targz.yaml
@@ -21,5 +21,7 @@ spec:
             value: gs://build-crd-tests/archive.tar.gz
           - name: artifactType
             value: TarGzArchive
+          # NB: The build-gcs PipelineResource type is deprecated, and will be
+          # removed in a future release.
           - name: type
             value: build-gcs
diff --git a/examples/v1beta1/taskruns/build-gcs-zip.yaml b/examples/v1beta1/taskruns/build-gcs-zip.yaml
index c6807f481f0..65541764e63 100644
--- a/examples/v1beta1/taskruns/build-gcs-zip.yaml
+++ b/examples/v1beta1/taskruns/build-gcs-zip.yaml
@@ -21,5 +21,7 @@ spec:
             value: gs://build-crd-tests/archive.zip
           - name: artifactType
             value: ZipArchive
+          # NB: The build-gcs PipelineResource type is deprecated, and will be
+          # removed in a future release.
           - name: type
             value: build-gcs
diff --git a/pkg/apis/resource/v1alpha1/pipeline_resource_types.go b/pkg/apis/resource/v1alpha1/pipeline_resource_types.go
index 3d6cc12fc75..b1171f87919 100644
--- a/pkg/apis/resource/v1alpha1/pipeline_resource_types.go
+++ b/pkg/apis/resource/v1alpha1/pipeline_resource_types.go
@@ -56,6 +56,7 @@ const (
 
 	// PipelineResourceTypeBuildGCS is the subtype for the BuildGCSResources, which is simialr to the GCSResource but
 	// with additional functionality that was added to be compatible with knative build.
+	// Deprecated: This PipelineResource type is deprecated and support will be removed in a future release.
 	PipelineResourceTypeBuildGCS PipelineResourceType = "build-gcs"
 )