Sanity-plugin-country-state-select NPM

sanity-plugin-country-state-select

This is a Sanity Studio v3 plugin.

What is it?

A sanity plugin to generate custom field for countries and states in the ISO 3166 standard for Sanity.

Country List input

Country List Dropdown

Country List Payload

Installation

npm i sanity-plugin-country-state-select

Usage

Add it as a plugin in sanity.config.ts (or .js):

import {countryStateListPlugin} from 'sanity-plugin-country-state-select'

export default defineConfig({
  // ...
  plugins: [countryStateListPlugin()],
})

Now you can use the countrieslist type in your schema types:

import {defineType, defineField} from 'sanity'

defineType({
  // [...]
  fields: [
    defineField(
      {
        type: 'code',
        name: 'myCodeField',
        title: 'My code field',
      },
      {
        title: 'Countries',
        name: 'countries',
        type: 'countrieslist', // required
        options: {
          showStates: true,
          placeholder: 'Select country',
          showIcon: true,
        },
      },
    ),
  ],
})

If you use @sanity-typed, import countryStateListPluginTyped instead to get the correct types in your documents:

import {countryStateListPluginTyped} from 'sanity-plugin-country-state-select'

export default defineConfig({
  // ...
  plugins: [countryStateListPluginTyped()],
})