GDAL-VECTOR-CONVERT(1)               GDAL               GDAL-VECTOR-CONVERT(1)

<?><?><?> (NAME)
       gdal-vector-convert - <?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?>

       <?><?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?> 3.11.


<?><?><?><?><?> <?><?><?><?><?> (SYNOPSIS)

          Usage: gdal vector convert [OPTIONS] <INPUT> <OUTPUT>

          Convert a vector dataset.

          Positional arguments:
            -i, --input <INPUT>                                  Input vector datasets [required] [not available in pipelines]
            -o, --output <OUTPUT>                                Output vector dataset [required] [not available in pipelines]

          Common Options:
            -h, --help                                           Display help message and exit
            --json-usage                                         Display usage as JSON document and exit
            --config <KEY>=<VALUE>                               Configuration option [may be repeated]
            -q, --quiet                                          Quiet mode (no progress bar or warning message) [not available in pipelines]

          Options:
            -l, --layer, --input-layer <INPUT-LAYER>             Input layer name(s) [may be repeated] [not available in pipelines]
            -f, --of, --format, --output-format <OUTPUT-FORMAT>  Output format ("GDALG" allowed) [not available in pipelines]
            --co, --creation-option <KEY>=<VALUE>                Creation option [may be repeated] [not available in pipelines]
            --lco, --layer-creation-option <KEY>=<VALUE>         Layer creation option [may be repeated] [not available in pipelines]
            --overwrite                                          Whether overwriting existing output dataset is allowed [not available in pipelines]
            --update                                             Whether to open existing dataset in update mode [not available in pipelines]
            --overwrite-layer                                    Whether overwriting existing output layer is allowed [not available in pipelines]
            --append                                             Whether appending to existing layer is allowed [not available in pipelines]
                                                                 Mutually exclusive with --upsert
            --output-layer <OUTPUT-LAYER>                        Output layer name [not available in pipelines]
            --skip-errors                                        Skip errors when writing features [not available in pipelines]
            --no-create-empty-layers                             Avoid creating layers to which no features will be written [not available in pipelines]

          Advanced Options:
            --if, --input-format <INPUT-FORMAT>                  Input formats [may be repeated] [not available in pipelines]
            --oo, --open-option <KEY>=<VALUE>                    Open options [may be repeated] [not available in pipelines]
            --output-oo, --output-open-option <KEY>=<VALUE>      Output open options [may be repeated] [not available in pipelines]
            --upsert                                             Upsert features (implies 'append') [not available in pipelines]
                                                                 Mutually exclusive with --append

<?><?><?><?><?><?><?> (DESCRIPTION)
       <?><?> gdal vector convert <?><?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?>.

<?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?> (STANDARD OPTIONS)

       --append
              <?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?>
              <?><?><?><?><?> <?><?> <?><?><?><?>(<?><?><?>) <?><?><?><?><?>
              <?><?><?><?> <?><?><?> <?><?> <?><?><?>.  <?><?><?>
              <?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?> <?><?><?><?>
              <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?>
              <?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>.

       --co, --creation-option <NAME>=<VALUE>
              <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?> <?><?> <?><?>
              <?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?>
              <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?>
              <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?>
              <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?>
              <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?>.
              <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?> GeoPackage
              <?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?>
              <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?>.

              <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?>.

              <?><?><?><?><?><?><?><?><?> <?><?><?><?>
              <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?>
              <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?><?> <?>
              <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?>
              <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>.
              <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?>
              <?><?><?><?> <?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?>
              <?><?> <?><?><?><?><?> --formats <?><?><?><?><?><?> <?><?><?><?>
              <?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>
              <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?>
              <?><?><?>. <?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?>
              <?><?><?><?> <?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?><?><?>
              <?><?><?><?> <?><?><?><?> <?><?> Vector drivers
              <?><?><?><?><?><?> <?><?><?><?>.

              <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?>
              <?><?><?><?><?><?><?><?><?> <?><?><?><?>
              <?><?><?><?><?><?><?><?><?><?><?> <?><?>
              <?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?>
              <?><?><?><?><?><?> <?><?><?><?><?>.

       --if, --input-format <format>
              <?><?><?> <?><?><?><?>/<?><?><?><?><?><?> <?><?><?><?><?><?>
              <?><?><?><?> <?><?><?> <?><?><?><?> <?><?><?><?>(<?><?><?>)
              <?><?><?><?><?>. <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?>
              <?><?><?><?><?> <?><?><?><?><?> <?><?><?> <?><?>
              <?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?><?>
              <?><?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?>
              <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?><?>
              <?><?> <?><?> <?><?><?><?><?><?><?> <?><?><?>.  <?><?><?>
              <?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?>
              <?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>
              <?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?>.
              <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?>
              <?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?> <?><?>
              <?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?>
              <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>
              <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>.

              <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?>.

       --input-layer <INPUT-LAYER>
              <?><?><?> <?><?> <?><?> <?><?><?> <?><?><?><?> <?><?>
              <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?>.
              <?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?>
              <?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?>
              <?><?>.

       --lco, --layer-creation-option <NAME>=<VALUE>
              <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?> <?><?> <?><?>
              <?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?>
              <?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?><?><?> <?><?>
              <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>
              <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?>
              <?><?><?>. <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?>
              GeoPackage <?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?>
              <?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>
              <?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?> <?><?><?><?><?>
              (geometry)<?> <?><?><?><?><?> <?><?><?><?><?> <?><?>
              <?><?><?><?><?><?><?> <?> <?><?><?><?> <?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?>.

              <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?>.

              <?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?>
              <?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?><?>
              <?><?><?><?> <?><?><?><?><?><?> <?><?><?> <?> <?><?><?><?>
              <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?> <?><?><?><?><?>
              <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?>.
              <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?>
              <?><?><?><?> <?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?>
              <?><?> <?><?><?><?><?> --formats <?><?><?><?><?><?> <?><?><?><?>
              <?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?>
              <?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?>
              <?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?>
              <?><?><?><?><?><?> <?><?><?>. <?><?><?><?>
              <?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?>
              <?><?><?><?><?> <?><?> <?><?><?><?><?><?><?> <?><?><?><?>
              <?><?><?><?> <?><?> Vector drivers <?><?><?><?><?><?>
              <?><?><?><?>.

              <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?>
              <?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?>
              <?><?><?><?><?><?><?><?><?> <?><?><?><?>
              <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?>
              <?><?><?><?><?>.

       --no-create-empty-layers
              <?><?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?> 3.13.


              <?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?>
              <?><?><?> <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?>
              <?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?>
              <?><?><?><?><?><?>.

       --oo, --open-option <NAME>=<VALUE>
              <?><?><?><?><?> <?><?><?> <?><?><?><?>
              <?><?><?><?><?><?><?><?><?><?><?> (<?><?><?><?> <?><?>
              <?><?><?><?>).

              <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?>.

       -f, --of, --format, --output-format <OUTPUT-FORMAT>
              <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?>
              <?><?><?><?> <?><?><?><?><?><?><?>. <?><?><?><?><?><?>
              <?><?><?><?> <?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?>
              <?><?><?> <?><?> <?><?><?> <?><?><?><?>: gdal --formats | grep
              vector | grep rw | sort

       --output-layer <NAME>
              <?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?><?>
              <?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?> <?><?>
              <?><?><?><?><?> <?><?><?><?><?><?> <?><?>. <?><?><?>
              <?><?><?><?> <?><?><?><?><?> <?><?><?> <?><?><?><?><?><?><?><?>
              <?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?><?><?><?>
              <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?>.

       --output-open-option, --output-oo <NAME>=<VALUE>
              <?><?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?> 3.12.


              <?><?><?><?><?> <?><?><?> <?><?><?><?>
              <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?>
              <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?> (<?><?><?><?>
              <?><?> <?><?><?><?>).

              <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?>.

       --overwrite
              <?><?> <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>
              <?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?><?><?>
              <?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?>
              <?><?><?>.  <?><?> <?><?><?> <?><?><?> <?><?><?><?><?>
              <?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?>
              <?><?><?><?><?> <?><?> <?><?><?><?> <?><?>
              <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?>
              <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> gdal <?><?>
              <?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>.

       --overwrite-layer
              <?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?>
              <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?>
              <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?> <?><?>
              <?><?><?>.

       --skip-errors
              <?><?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?> 3.12.


              <?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?>
              <?><?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?>
              <?><?><?><?><?>(<?><?>) <?><?><?><?><?><?> <?><?><?><?><?>
              <?><?><?><?> <?><?> <?><?><?>. <?><?><?><?> <?><?><?><?><?>
              <?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?>
              <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?>
              <?><?> <?><?><?><?><?> <?><?> <?><?> <?><?><?><?>
              <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?><?>
              <?><?><?> <?><?><?><?><?> <?><?><?> <?><?><?><?><?><?><?> <?><?>
              <?><?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?>
              <?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?>.

       --update
              <?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?>
              <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?>
              <?><?><?><?><?> <?><?> <?><?><?><?>
              <?><?><?><?><?><?><?><?><?><?><?> (update) <?><?><?> <?><?><?>
              <?><?> <?><?><?>.

       --upsert
              <?><?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?> 3.12.


              <?><?><?><?><?><?><?> <?><?> --append <?><?> <?><?> <?><?>
              <?><?><?><?><?><?> OGRLayer::UpsertFeature() <?><?><?><?>
              <?><?><?> <?><?> <?><?><?><?><?><?><?><?><?><?><?>
              <?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?> <?><?>
              OGRLayer::CreateFeature() <?><?><?><?><?><?><?>
              <?><?><?><?><?><?>.

              <?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?>
              <?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?><?><?> <?><?><?> <?><?><?>: GPKG --
              GeoPackage vector<?> Elasticsearch: Geographically Encoded
              Objects for Elasticsearch <?> MongoDBv3
              (<?><?><?><?><?><?><?><?><?><?> <?><?> upsert <?><?>
              <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?> GDAL_DCAP_UPSERT <?><?> <?><?><?><?><?>
              <?><?><?><?><?><?><?>).

              <?><?><?><?><?><?> upsert<?> <?><?> <?><?><?><?> <?><?><?><?><?>
              <?><?><?><?> FID <?><?><?><?><?> <?><?><?><?><?> (<?>
              <?><?><?><?> <?><?><?><?><?> <?><?><?> <?><?><?><?> FID)<?>
              <?><?> FID <?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?>
              <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?>
              <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?>.
              <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?> FID <?><?>
              <?><?><?><?><?><?><?><?> <?><?><?><?> <?> <?><?><?><?>
              <?><?><?><?><?> <?><?><?><?><?> <?><?><?>.

              <?><?><?><?> <?><?><?><?><?><?> GPKG<?> <?><?><?><?><?><?>
              <?><?><?><?><?> upsert <?><?><?><?><?><?> <?><?> FID
              <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?>
              <?><?><?><?><?><?><?> <?><?><?> <?><?><?><?> <?><?><?><?>
              (<?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> --unset-fid <?><?>
              gdal vector edit <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?>
              FID <?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?>
              <?><?><?>)<?> <?><?><?><?><?> <?><?> <?><?><?> <?><?> <?><?>
              <?><?><?><?> UNIQUE <?><?><?><?> <?><?><?><?><?> <?><?><?><?>
              <?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?>
              <?><?><?><?><?>.

       -q, --quiet
              <?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?> <?>
              <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?>.

<?><?><?><?><?> <?><?><?><?> (EXIT STATUS)
       <?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?>
       <?><?> <?><?><?><?><?> 0 <?> <?><?> <?><?><?><?> <?><?><?><?> <?><?><?>
       <?><?><?><?><?><?> <?><?><?> <?><?><?> <?><?>
       <?><?><?><?><?><?><?><?><?><?><?> (<?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?>
       <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?>).

<?><?><?><?><?><?><?> (EXAMPLES)
   <?><?><?><?> <?>: <?><?><?><?><?> <?><?><?><?> poly.shp <?><?> <?><?>
       GeoPackage

          $ gdal vector convert poly.shp output.gpkg

   <?><?><?><?> <?>: <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?>
       <?><?><?><?> line.shp <?><?> <?><?> GeoPackage <?><?><?><?><?> <?>
       <?><?><?><?><?> <?><?><?> <?><?> <?><?> "lines"

          $ gdal vector convert --update --output-layer=lines line.shp output.gpkg

   <?><?><?><?> <?>: <?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?>
       poly2.shp <?><?> <?><?><?><?> <?><?><?><?><?> poly <?><?> <?><?>
       GeoPackage<?> <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?>

          $ gdal vector convert --quiet --append --output-layer=poly poly2.shp output.gpkg

<?><?><?><?><?><?><?><?><?> (AUTHORS)
       Even Rouault <even.rouault@spatialys.com>

<?><?><?><?><?><?><?><?> <?> <?><?><?><?><?> (COPYRIGHT)
       1998-2026

                                August 18, 2026         GDAL-VECTOR-CONVERT(1)