<p>The Workflows <code>version</code> field was used to issue warnings for deprecation or breaking changes during v2 Beta, and it is deprecated as of CircleCI v2.1.</p>
<p>2 is the only valid number besides 1</p>

CC BY-SA 4.0
2021-03-18T20:37:43.993Z
2021-03-18T20:37:43.993Z
gkee
<p>I keep seeing this pattern around, and I haven't been able to figure out <em>why</em> people do it. I figure there's some dusty tome somewhere explaining why, or maybe just my google skills are off today, but can anyone tell me <em>why</em> so many people have <code>workflows</code> at version 2?</p>
<p>e.g. the example <a href="https://web.archive.org/web/20200921001733/https://circleci.com/docs/2.0/workflows/#using-workspaces-to-share-data-among-jobs" rel="nofollow noreferrer">here</a>, excerpt below</p>
<pre><code>version: 2.1

executors:
  my-executor:
    docker:
      - image: buildpack-deps:jessie
    working_directory: /tmp

jobs:
  flow:
    executor: my-executor
    steps:
      - ...

  downstream:
    executor: my-executor
    steps:
      - ...

workflows:
  version: 2

  btd:
    jobs:
      - flow
      - downstream:
          requires:
            - flow
</code></pre>
<p>I figure I should probably be cargo-culting this in until I know <em>why</em> people do it, but I dislike doing that without any understanding :)</p>
<p>Thanks!</p>

<circleci>
Why do so many circleCI configs use `version: 2` for their workflows?
HunnyBear
# Why do so many circleCI configs use `version: 2` for their workflows?

(Asked by: username_0 on 2020-11-12)

I keep seeing this pattern around, and I haven't been able to figure out why people do it. I figure there's some dusty tome somewhere explaining why, or maybe just my google skills are off today, but can anyone tell me why so many people have workflows at version 2?
e.g. the example here, excerpt below
version: 2.1

executors:
  my-executor:
    docker:
      - image: buildpack-deps:jessie
    working_directory: /tmp

jobs:
  flow:
    executor: my-executor
    steps:
      - ...

  downstream:
    executor: my-executor
    steps:
      - ...

workflows:
  version: 2

  btd:
    jobs:
      - flow
      - downstream:
          requires:
            - flow

I figure I should probably be cargo-culting this in until I know why people do it, but I dislike doing that without any understanding :)
Thanks!

**Tags:** circleci


---

## 1 answers

### Answer by username_1 on 2021-03-18. Score: 1 | Accepted answer

The Workflows `version` field was used to issue warnings for deprecation or breaking changes during v2 Beta, and it is deprecated as of CircleCI v2.1.

2 is the only valid number besides 1


---

