<br />

|---|
| [![](https://www.tensorflow.org/images/GitHub-Mark-32px.png) View source on GitHub](https://github.com/tensorflow/tensorflow/blob/v2.21.0/tensorflow/core/example/feature.proto) |

Used in [`tf.train.Example`](https://www.tensorflow.org/api_docs/python/tf/train/Example) protos. Holds a list of byte-strings.

#### View aliases


**Compat aliases for migration**

See
[Migration guide](https://www.tensorflow.org/guide/migrate) for
more details.

[`tf.compat.v1.train.BytesList`](https://www.tensorflow.org/api_docs/python/tf/train/BytesList)

<br />

### Used in the notebooks

| Used in the tutorials |
|---|
| - [TFRecord and tf.train.Example](https://www.tensorflow.org/tutorials/load_data/tfrecord) - [Graph-based Neural Structured Learning in TFX](https://www.tensorflow.org/tfx/tutorials/tfx/neural_structured_learning) - [Preprocessing data with TensorFlow Transform](https://www.tensorflow.org/tfx/tutorials/transform/census) - [Graph regularization for sentiment classification using synthesized graphs](https://www.tensorflow.org/neural_structured_learning/tutorials/graph_keras_lstm_imdb) |

An `Example` proto is a representation of the following python type:

    Dict[str,
         Union[List[bytes],
               List[int64],
               List[float]]]

This proto implements the `List[bytes]` portion.

    from google.protobuf import text_format
    example = text_format.Parse('''
      features {
        feature {key: "my_feature"
                 value {bytes_list {value: ['abc', '12345' ]} } }
      }''',
      tf.train.Example())

    example.features.feature['my_feature'].bytes_list.value
    ["abc", "12345"]

Use [`tf.io.parse_example`](https://www.tensorflow.org/api_docs/python/tf/io/parse_example) to extract tensors from a serialized `Example` proto:

    tf.io.parse_example(
        example.SerializeToString(),
        features = {'my_feature': tf.io.RaggedFeature(dtype=tf.string)})
    {'my_feature': <tf.Tensor: shape=(2,), dtype=string,
                               numpy=array([b'abc', b'12345'], dtype=object)>}

See the [`tf.train.Example`](https://www.tensorflow.org/tutorials/load_data/tfrecord#tftrainexample)
guide for usage details.

<br />

<br />

<br />

| ## Attributes ||
|---|---|
| `value` | `repeated bytes value` |

<br />