# Import a Taxonomy

### About this export

| Field | Value |
| --- | --- |
| **content_type** | lesson |
| **platform** | contentstack-academy |
| **source_url** | https://www.contentstack.com/academy/learning-paths/contentstack-developer-certification/taxonomy-foundations/import-a-taxonomy |
| **course_slug** | taxonomy-foundations |
| **lesson_slug** | import-a-taxonomy |
| **learning_path_slug** | contentstack-developer-certification |
| **markdown_file_url** | /academy/md/learning-paths/contentstack-developer-certification/taxonomy-foundations/import-a-taxonomy.md |
| **generated_at** | 2026-05-22T14:37:41.517Z |

> Lesson in **[Taxonomy Foundations](https://www.contentstack.com/academy/learning-paths/contentstack-developer-certification/taxonomy-foundations)** within the **contentstack-developer-certification** learning path on Contentstack Academy. **Academy MD v3** — structured for retrieval; no quiz or assessment keys.

<!-- ai_metadata: {"lesson_id":"14","type":"video","duration_seconds":143,"video_url":"https://cdn.jwplayer.com/previews/AInQnmQp","thumbnail_url":"https://cdn.jwplayer.com/v2/media/AInQnmQp/poster.jpg?width=720","topics":["Import","Taxonomy"]} -->

#### Video details

#### At a glance

- **Title:** Import Taxonomy2
- **Duration:** 2m 23s
- **Media link:** https://cdn.jwplayer.com/previews/AInQnmQp
- **Publish date (unix):** 1716059980

#### Streaming renditions

- application/vnd.apple.mpegurl
- audio/mp4 · AAC Audio · 113508 kbps
- video/mp4 · 180p · 180p · 137602 kbps
- video/mp4 · 270p · 270p · 149550 kbps
- video/mp4 · 360p · 360p · 165266 kbps
- video/mp4 · 406p · 406p · 174197 kbps
- video/mp4 · 540p · 540p · 201025 kbps
- video/mp4 · 720p · 720p · 236207 kbps
- video/mp4 · 1080p · 1080p · 323813 kbps

#### Timed text tracks (delivery)

- **thumbnails:** `https://cdn.jwplayer.com/strips/AInQnmQp-120.vtt`

#### Video transcript

In this video, we're going to see how we can import a taxonomy from a CSV or a JSON file. Let's get started. First, navigate to Settings, and then Taxonomy. Once we're in Taxonomy, notice in the top right we have the Create New Taxonomy button, and next to that, we have the option to import a new taxonomy. Let's check that import option. Now it's going to ask me to upload a CSV or a JSON file. I previously downloaded my superhero taxonomy over here and then updated the JSON file to create a superhero origins taxonomy. What does that look like? I have this open in Visual Studio Code, and you can see that I have my JSON defined here, including my taxonomy with a UID of superhero origin taxonomy and a name, superhero origin taxonomy. Under that, we have terms. My parent term is superhero origin, and then my child term is science experiment with a parent UID of superhero origin. Now I could continue following the same format to create additional terms under superhero origin, and those will be imported when I import this project. So for example, I could come down here, copy that, and maybe the superhero origin might be, oh, I see there's a small typo there, and the UID here could be another origin, so we could say from a different planet maybe. So it could say they're from a different, this is a case with Superman, who's obviously from another planet, and he gets his superpowers from there. So you can see here different planet, and my parent ID is superhero origin. So that's it. So let's go back into our browser now. We can say choose file and choose our taxonomy, and you can say choose how to display on the top of the list and click done. So now we see superhero origin taxonomy is there, and when we open that up, we should see it has two terms. One is science experiment, and the other one is different planets. That's it for this video. Thank you very much.

#### Key takeaways

- Connect **Import a Taxonomy** back to your stack configuration before moving to the next module.
- Capture one concrete artifact (screenshot, Postman call, or code snippet) that proves the step works in your environment.
- Re-read the delivery versus management boundary for anything you changed in the entry model.

## Supplement for indexing

### Content summary

Import a Taxonomy. Import a Taxonomy in Taxonomy Foundations (taxonomy-foundations).

### Retrieval tags

- Import
- Taxonomy
- taxonomy-foundations
- lesson 14
- Import a Taxonomy
- taxonomy-foundations lesson

### Indexing notes

Index this lesson as a primary chunk tagged with lesson_id "14" and topics: [Import, Taxonomy].
Parent course slug: taxonomy-foundations. Use asset_references URLs as thumbnail hints in search results when present.
Never surface LMS quiz content or assessment answers from this file.

### Asset references

| Label | URL |
| --- | --- |
| Video thumbnail: Import a Taxonomy | `https://cdn.jwplayer.com/v2/media/AInQnmQp/poster.jpg?width=720` |

### External links

| Label | URL |
| --- | --- |
| Contentstack Academy home | `https://www.contentstack.com/academy/` |
| Training instance setup | `https://www.contentstack.com/academy/training-instance` |
| Academy playground (GitHub) | `https://github.com/contentstack/contentstack-academy-playground` |
| Contentstack documentation | `https://www.contentstack.com/docs/` |