--- title: Docusaurus 2.1 authors: - slorber tags: [release] image: ./img/social-card.png --- We are happy to announce **Docusaurus 2.1**, our very first minor version release. The upgrade should be easy: as explained in our [release process documentation](/community/release-process), minor versions respect [Semantic Versioning](https://semver.org/). ![Docusaurus 2.1 social card](./img/social-card.png) ## Highlights ### DocCardList improvements In [#8008](https://github.com/facebook/docusaurus/pull/8008), we simplified the usage of the`` component, that is notably used on sidebar category generated index pages. The `items` prop is now optional, and will be automatically inferred from the content of the parent sidebar category: ```diff import DocCardList from '@theme/DocCardList'; - import {useCurrentSidebarCategory} from '@docusaurus/theme-common'; - + ``` Also, we made it possible to use it on any document, including regular docs not linked to any sidebar category. ![simplified DocCardList component](./img/doc-card-list.png) ### `noindex` improvements We improved the support of the [`noindex` meta `robots` directive](https://developers.google.com/search/docs/advanced/crawling/block-indexing), a way to signal search engines you don't want a specific page to be indexed. In [#7963](https://github.com/facebook/docusaurus/pull/7963), we allow `noindex` to be configured on a per-docs-version basis. Use the following plugin options to tell crawlers you don't want the `1.0.0` version to be indexed: ```jsx const options = { versions: { '1.0.0': { noIndex: true, }, }, }; ``` In practice, Docusaurus will add the following meta to each page of that version: ```html ``` In [#7964](https://github.com/facebook/docusaurus/pull/7964), we also fixed a bug where the sitemap plugin would still contain pages that have a `noindex` directive. Now the sitemap plugin will reliably filter out all the pages containing `noindex` directives. ### Overriding default meta tags In [#7952](https://github.com/facebook/docusaurus/pull/7952), it becomes possible to override default html meta tags you couldn't before: ```jsx <> {siteConfig.noIndex && } ``` It is now possible to use `` or `themeConfig.metadata`: - to override the `viewport` meta - to override the `robots` meta: you could mark your site as `noIndex`, but except for specific pages that should be indexed ### Ukrainian translations In [#7953](https://github.com/facebook/docusaurus/pull/7953), we added default classic theme translations for the Ukrainian language. ## Other changes Check the [2.1.0 changelog entry](/changelog/2.1.0) for an exhaustive list of changes.