{"id":44668309,"url":"https://github.com/andybywire/sanity-plugin-taxonomy-manager","last_synced_at":"2026-02-15T01:18:42.631Z","repository":{"id":45793002,"uuid":"470293675","full_name":"andybywire/sanity-plugin-taxonomy-manager","owner":"andybywire","description":"Create and manage SKOS compliant taxonomies, thesauri, and classification schemes in Sanity Studio.","archived":false,"fork":false,"pushed_at":"2026-02-05T19:13:48.000Z","size":56873,"stargazers_count":26,"open_issues_count":0,"forks_count":8,"subscribers_count":3,"default_branch":"main","last_synced_at":"2026-02-06T04:38:20.762Z","etag":null,"topics":["cms","headless","sanity","sanity-io","sanity-studio","sanitycms","taxonomy"],"latest_commit_sha":null,"homepage":"https://sanitytaxonomymanager.com","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/andybywire.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"docs/contributing.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2022-03-15T18:56:19.000Z","updated_at":"2026-02-05T19:13:53.000Z","dependencies_parsed_at":"2024-06-25T23:36:45.123Z","dependency_job_id":"7d021d7d-4f3c-4aa2-922b-503f5c17fe46","html_url":"https://github.com/andybywire/sanity-plugin-taxonomy-manager","commit_stats":{"total_commits":250,"total_committers":2,"mean_commits":125.0,"dds":"0.0040000000000000036","last_synced_commit":"4345132f27bc5e4a4740b3b34ea7c48a0b13d096"},"previous_names":[],"tags_count":62,"template":false,"template_full_name":null,"purl":"pkg:github/andybywire/sanity-plugin-taxonomy-manager","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/andybywire%2Fsanity-plugin-taxonomy-manager","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/andybywire%2Fsanity-plugin-taxonomy-manager/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/andybywire%2Fsanity-plugin-taxonomy-manager/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/andybywire%2Fsanity-plugin-taxonomy-manager/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/andybywire","download_url":"https://codeload.github.com/andybywire/sanity-plugin-taxonomy-manager/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/andybywire%2Fsanity-plugin-taxonomy-manager/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29461395,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-14T22:42:09.113Z","status":"ssl_error","status_checked_at":"2026-02-14T22:42:05.053Z","response_time":53,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cms","headless","sanity","sanity-io","sanity-studio","sanitycms","taxonomy"],"created_at":"2026-02-15T01:18:42.045Z","updated_at":"2026-02-15T01:18:42.621Z","avatar_url":"https://github.com/andybywire.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Sanity Taxonomy Manager\n\n![NPM Version](https://img.shields.io/npm/v/sanity-plugin-taxonomy-manager?style=flat-square)\n![License](https://img.shields.io/npm/l/sanity-plugin-taxonomy-manager?style=flat-square)\n\n### Create and manage SKOS compliant taxonomies, thesauri, and classification schemes in Sanity Studio.\n\n\u003c!-- Taxonomies are crucial tools for organization and interoperability between and across data sets. Taxonomy Manager provides a way for content authors to create, use, and maintain standards compliant taxonomies in Sanity Studio.\n\nThe Taxonomy Manager document schema is based on the [World Wide Web Consortium](https://www.w3.org/) (W3C) [Simple Knowledge Organization Scheme](https://www.w3.org/TR/skos-reference/) (SKOS) recommendation. Concept and concept scheme editor tools include standard SKOS properties, hints for creating consistent concepts and vocabularies, and validation functions for preventing consistency errors. --\u003e\n\n![taxonomy manager plugin screenshot](docs/_images/taxonomyManager.png)\n\n## Documentation\n\nFor full documentation, visit [sanitytaxonomymanager.com](https://sanitytaxonomymanager.com).\n\n## Features\n\n\u003c!-- make this more concise --\u003e\n\n- Adds two document types to your Sanity schema which are used to generate [SKOS](https://www.w3.org/TR/skos-primer/) compliant concepts and taxonomies: `skosConcept` and `skosConceptScheme`\n- Includes reference filter helpers to allow you to easily include a specific taxonomy, or particular branch of a taxonomy in your Sanity documents\n- Encourages taxonomy and thesaurus design best practices by enforcing [disjunction between Broader and Related relationships](https://www.w3.org/TR/skos-reference/#L2422) and [disjunction between Preferred and Alternate/Hidden labels](https://www.w3.org/TR/skos-reference/#L1567)\n- Standards compliant architecture means that taxonomy terms and structures can be migrated to standards compliant standalone tools when you need higher level taxonomy and knowledge graph support.\n\n## Installation\n\nIn your Sanity project folder, run\n\n```bash\nnpm i sanity-plugin-taxonomy-manager\n```\n\nor\n\n```bash\nyarn add sanity-plugin-taxonomy-manager\n```\n\n## Configuration\n\nAdd the plugin to your [project configuration](https://www.sanity.io/docs/configuration#51515480034b) to add the Taxonomy Manager Tool to your studio workspace.\n\n```js\n// sanity.config.js\n\nimport {defineConfig} from 'sanity'\nimport {structureTool} from 'sanity/structure'\nimport {taxonomyManager} from 'sanity-plugin-taxonomy-manager'\nimport {schemaTypes} from './schemas'\n\nexport default defineConfig({\n  name: 'default',\n  title: 'Sanity Studio',\n  projectId: '\u003cprojectId\u003e',\n  dataset: 'production',\n  plugins: [\n    structureTool(),\n    // Include the taxonomy manager plugin\n    taxonomyManager({\n      // Optional: Set a Base URI to use for new concepts \u0026 concept schemes\n      baseUri: 'https://example.com/',\n      // Optional: Use `customConceptFields` and `customSchemeFields` keys to add custom fields to Concept or Concept Scheme document types\n      customConceptFields: [\n        {\n          name: 'sameAs',\n          title: 'Same As',\n          type: 'url',\n          description:\n            'Specify a fully qualified IRI that identifies the same concept in another vocabulary',\n        },\n      ],\n    }),\n  ],\n  schema: {\n    types: schemaTypes,\n  },\n})\n```\n\nThe plugin adds `skosConcept` and `skosConceptScheme` document types to your studio. Use a filter on `documentTypeListItems` in the [desk tool configuration](https://www.sanity.io/docs/desk-tool-api) to exclude taxonomy manager document types from your main document view.\n\n```js\n// sanity.config.js\n\nimport {defineConfig} from 'sanity'\nimport {structureTool} from 'sanity/structure'\nimport {taxonomyManager} from 'sanity-plugin-taxonomy-manager'\nimport {schemaTypes} from './schemas'\n\nexport default defineConfig({\n  name: 'default',\n  title: 'Sanity Studio',\n  projectId: '\u003cprojectId\u003e',\n  dataset: 'production',\n  plugins: [\n    structureTool({\n      structure: (S) =\u003e\n        S.list()\n          .title('Content')\n          .items([\n            ...S.documentTypeListItems().filter(\n              (listItem) =\u003e !['skosConcept', 'skosConceptScheme'].includes(listItem.getId())\n            ),\n          ]),\n    }),\n    taxonomyManager(),\n  ],\n  schema: {\n    types: schemaTypes,\n  },\n})\n```\n\n## Contributing\n\nSee something that could be improved (or a bug that should be fixed)? Please feel free to pitch in.\n\n- This plugin uses [@sanity/plugin-kit](https://github.com/sanity-io/plugin-kit)\n  with default configuration for build \u0026 watch scripts.\n\n- See [Testing a plugin in Sanity Studio](https://github.com/sanity-io/plugin-kit#testing-a-plugin-in-sanity-studio)\n  on how to run the plugin with hot-reload in the studio.\n\n### Component Diagrams\n\nThe following diagrams map out the relationships between the components used in this plugin and are intended to help those interested in contributing to the project orient themselves. The Taxonomy Manager tree view is designed to support polyhierarchy, and to provide UI affordances common to other taxonomy management tools, both of which lend some complexity to the component structure.\n\n\u003e [!TIP]\n\u003e You **do not** need to understand any of this to use the plugin!\n\n\u003cDetails\u003e\n\u003cSummary\u003e\u003ch4\u003eTree View\u003c/h4\u003e\u003c/Summary\u003e\n\nThe [Tree View component](docs/_images/taxonomyManager.png) creates the user interface for interacting with a given taxonomy (SKOS Concept Scheme) visually in the Sanity Structure tool.\n\n```mermaid\ngraph BT\n    subgraph SchemeContext.Provider\n      direction BT\n      Hierarchy.tsx--\u003eTreeView.tsx\n      subgraph TreeContext.Provider\n        direction BT\n        TreeStructure.tsx--\u003eHierarchy.tsx\n        TopConcepts.tsx[\n          TopConcepts.tsx\n          \u003ci style=\"color: gray; font-size: small\"\u003euses SchemeContext\u003c/i\u003e\n          \u003ci style=\"color: gray; font-size: small\"\u003euses TreeContext\u003c/i\u003e\n        ]--\u003eTreeStructure.tsx\n        Concepts.tsx[\n          Concepts.tsx\n          \u003ci style=\"color: gray; font-size: small\"\u003euses SchemeContext\u003c/i\u003e\n          \u003ci style=\"color: gray; font-size: small\"\u003euses TreeContext\u003c/i\u003e\n        ]--\u003eTreeStructure.tsx\n\n\n        %% Sequence below maintains RTL ordering:\n        ConceptDetailLink.tsx--\u003eTopConcepts.tsx\n        ConceptDetailLink.tsx--\u003eConcepts.tsx\n\n        ChildConcepts.tsx--\u003eTopConcepts.tsx\n        ChildConcepts.tsx--\u003eConcepts.tsx\n        Children.tsx--\u003eChildConcepts.tsx\n\n        ConceptDetailDialogue.tsx--\u003eConcepts.tsx\n        ConceptDetailDialogue.tsx--\u003eTopConcepts.tsx\n\n        ConceptDetailLink.tsx--\u003eChildren.tsx\n        ConceptDetailDialogue.tsx--\u003eChildren.tsx\n      end\n    end\n```\n\n\u003c/Details\u003e\n\n\u003cDetails\u003e\n\u003cSummary\u003e\u003ch4\u003eInput Components\u003c/h4\u003e\u003c/Summary\u003e\n\nThe [ReferenceHierarchyInput and ArrayHierarchyInput components](https://sanitytaxonomymanager.com/#/?id=tree-view-input-component) afford a field-level hierarchical browse and selection experience for taxonomy terms. Both components draw on filter options supplied by the `schemeFilter` and `branchFilter` helper functions.\n\n```mermaid\ngraph BT\n    subgraph Input Components\n      direction BT\n      TreeView.tsx--\u003eArrayHierarchyInput.tsx[\n        ArrayHierarchyInput.tsx\n        \u003ci style=\"color: gray; font-size: small\"\u003erequires schemeFilter\u003c/i\u003e\n        \u003ci style=\"color: gray; font-size: small\"\u003eor branchFilter helper\u003c/i\u003e\n        ]\n      TreeView.tsx--\u003eReferenceHierarchyInput.tsx[\n        ReferenceHierarchyInput.tsx\n        \u003ci style=\"color: gray; font-size: small\"\u003erequires schemeFilter\u003c/i\u003e\n        \u003ci style=\"color: gray; font-size: small\"\u003eor branchFilter helper\u003c/i\u003e\n      ]\n      subgraph SchemeContext.Provider\n        InputHierarchy.tsx--\u003eTreeView.tsx\n        subgraph TreeContext.Provider\n          direction BT\n          TreeStructure.tsx--\u003eInputHierarchy.tsx\n          TopConcepts.tsx[\n            TopConcepts.tsx\n            \u003ci style=\"color: gray; font-size: small\"\u003euses SchemeContext\u003c/i\u003e\n            \u003ci style=\"color: gray; font-size: small\"\u003euses TreeContext\u003c/i\u003e\n          ]--\u003eTreeStructure.tsx\n          Concepts.tsx[\n            Concepts.tsx\n            \u003ci style=\"color: gray; font-size: small\"\u003euses SchemeContext\u003c/i\u003e\n            \u003ci style=\"color: gray; font-size: small\"\u003euses TreeContext\u003c/i\u003e\n          ]--\u003eTreeStructure.tsx\n          ChildConcepts.tsx--\u003eTopConcepts.tsx\n          ChildConcepts.tsx--\u003eConcepts.tsx\n          Children.tsx--\u003eChildConcepts.tsx\n        end\n      end\n    end\n```\n\n\u003c/Details\u003e\n\n## License\n\nMIT © Andy Fitzgerald\nSee LICENSE\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fandybywire%2Fsanity-plugin-taxonomy-manager","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fandybywire%2Fsanity-plugin-taxonomy-manager","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fandybywire%2Fsanity-plugin-taxonomy-manager/lists"}