create_vector

Add a new named dense vector to an existing collection. Requires Qdrant v1.18+.

Example

up:
  - op: create_vector
    collection: products
    name: image
    spec:
      size: 512
      distance: Dot
      on_disk: true
      datatype: float16

To tune the new vector's hnsw_config or quantization_config, follow it with an update_collection step — Qdrant's add-vector API doesn't accept those at create time.

Fields

FieldTypeRequiredDescription
collectionstringyesCollection to add the vector to.
namestringyesVector name (must be unique within the collection).
specVectorSpecyesVector configuration.

spec fields

FieldTypeDescription
sizeuintDimensionality. Immutable once created.
distanceCosine | Euclid | Dot | ManhattanDistance metric. Immutable.
on_diskboolStore vectors on disk rather than in RAM.
datatypefloat32 | uint8 | float16Element storage type.
hnsw_configHnswConfigSpecIgnored at create time — apply via update_collection.
quantization_configQuantizationSpecIgnored at create time — apply via update_collection.

Reversibility

Auto-reversible → delete_vector. Note the downgrade discards any embeddings written to the vector in the meantime — a deliberate, declared choice.