Skip to content

Constants

The Sanity Structure Tool exports the following constants that you can use in your configuration or custom document actions.


I18N_NAMESPACE

The default namespace key registered with the Sanity Studio internationalization framework.

Usage Example

ts
import { constants } from 'sanity-plugin-structure-tool';

console.log(constants.I18N_NAMESPACE);

SINGLETON_KEY

This key is used as a suffix for document IDs when singleton: true is set. The final ID is generated as ${schemaType}-${SINGLETON_KEY}.

Usage Example

ts
import { constants } from 'sanity-plugin-structure-tool';

// Use SINGLETON_KEY to check for singleton documents
if (documentId.endsWith(constants.SINGLETON_KEY)) {
  // ...
}

UNIQUE_ID_FIRST_VALUE

The default starting value used for auto-generated list item unique IDs.

Usage Example

ts
import { constants } from 'sanity-plugin-structure-tool';

console.log(constants.UNIQUE_ID_FIRST_VALUE);

URL_PATH_SEPARATOR

The character used as a separator when generating unique list item paths and IDs.

Usage Example

ts
import { constants } from 'sanity-plugin-structure-tool';

helpers.listing('category', {
  title: 'My Custom Category',
  id: ({ workspace, values }) => {
    return [workspace, values.uniqueId, 'custom'].join(constants.URL_PATH_SEPARATOR);
  },
});

Released under the MIT License.