# Publishing Schema & Version Control ### About this export | Field | Value | | --- | --- | | **content_type** | lesson | | **platform** | contentstack-academy | | **source_url** | https://www.contentstack.com/academy/courses/data-insights-data-ingestion-profile-construction/data-insights-course-3--publishing-schema-version-control | | **course_slug** | data-insights-data-ingestion-profile-construction | | **lesson_slug** | data-insights-course-3--publishing-schema-version-control | | **markdown_file_url** | /academy/md/courses/data-insights-data-ingestion-profile-construction/data-insights-course-3--publishing-schema-version-control.md | | **generated_at** | 2026-04-28T06:55:44.150Z | > Part of **[Data Ingestion & Profile Construction](https://www.contentstack.com/academy/courses/data-insights-data-ingestion-profile-construction)** on Contentstack Academy. **Academy MD v3** — structured for retrieval; no quiz or assessment keys. #### Video details #### At a glance - **Title:** 14-data-insights-publishing-schema - **Duration:** 1m 38s - **Media link:** https://cdn.jwplayer.com/previews/PCj1HuBz - **Publish date (unix):** 1752873656 #### Streaming renditions - application/vnd.apple.mpegurl - audio/mp4 · AAC Audio · 113834 kbps - video/mp4 · 270p · 270p · 171748 kbps #### Transcript The final step as you're changing your schema is to actually publish the version. So if on the left hand side under schema, I go to versions, you'll see that okay, there's three unpublished changes that we've just made. So I actually have to go in here and hit publish changes, it'll walk me through the sort of diff what was added, we added a new field, we added two mappings, there's no ranking changes, we will come back to ranking and the importance of that, you know, in a byfield or an identity field, we'll go through next. So you're going to name something around the version. So added, likely, we'll just do the same thing for the description. And I'm going to publish that change. So now at this point, all of those changes have been merged with my actual live schema. One caveat here to be aware of is, it can take some time for schema changes to be reflected in the UI and take effect. But if as you're playing with it, you're actually customizing the fields and adding some stuff, and it's not working right away, we have to kick what we call field info on our side, which is what refreshes all the things to make sure that the mappings and whatnot take place. #### Subtitles (WebVTT) ```webvtt WEBVTT 1 00:00:00.000 --> 00:00:20.440 The final step as you're changing your schema is to actually publish the version. 2 00:00:20.440 --> 00:00:24.260 So if on the left hand side under schema, I go to versions, you'll see that okay, there's 3 00:00:24.260 --> 00:00:27.520 three unpublished changes that we've just made. 4 00:00:27.520 --> 00:00:30.960 So I actually have to go in here and hit publish changes, it'll walk me through the sort of 5 00:00:30.960 --> 00:00:36.680 diff what was added, we added a new field, we added two mappings, there's no ranking 6 00:00:36.680 --> 00:00:40.560 changes, we will come back to ranking and the importance of that, you know, in a byfield 7 00:00:40.560 --> 00:00:43.840 or an identity field, we'll go through next. 8 00:00:43.840 --> 00:00:45.960 So you're going to name something around the version. 9 00:00:45.960 --> 00:00:58.000 So added, likely, we'll just do the same thing for the description. 10 00:00:58.000 --> 00:00:59.720 And I'm going to publish that change. 11 00:00:59.720 --> 00:01:05.840 So now at this point, all of those changes have been merged with my actual live schema. 12 00:01:05.840 --> 00:01:12.160 One caveat here to be aware of is, it can take some time for schema changes to be reflected 13 00:01:12.160 --> 00:01:15.640 in the UI and take effect. 14 00:01:15.640 --> 00:01:18.440 But if as you're playing with it, you're actually customizing the fields and adding 15 00:01:18.440 --> 00:01:23.600 some stuff, and it's not working right away, we have to kick what we call field info on 16 00:01:23.600 --> 00:01:27.280 our side, which is what refreshes all the things to make sure that the mappings and 17 00:01:27.280 --> 00:01:28.200 whatnot take place. ``` ```transcript [00:00] The final step as you're changing your schema is to actually publish the version. [00:20] So if on the left hand side under schema, I go to versions, you'll see that okay, there's [00:24] three unpublished changes that we've just made. [00:27] So I actually have to go in here and hit publish changes, it'll walk me through the sort of [00:30] diff what was added, we added a new field, we added two mappings, there's no ranking [00:36] changes, we will come back to ranking and the importance of that, you know, in a byfield [00:40] or an identity field, we'll go through next. [00:43] So you're going to name something around the version. [00:45] So added, likely, we'll just do the same thing for the description. [00:58] And I'm going to publish that change. [00:59] So now at this point, all of those changes have been merged with my actual live schema. [01:05] One caveat here to be aware of is, it can take some time for schema changes to be reflected [01:12] in the UI and take effect. [01:15] But if as you're playing with it, you're actually customizing the fields and adding [01:18] some stuff, and it's not working right away, we have to kick what we call field info on [01:23] our side, which is what refreshes all the things to make sure that the mappings and [01:27] whatnot take place. ``` #### Key takeaways - Connect **Publishing Schema & Version Control** 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 Publishing Schema & Version Control. Publishing Schema & Version Control in Data Ingestion & Profile Construction (data-insights-data-ingestion-profile-construction). ### Retrieval tags - Publishing - Schema - Version - Control - data-insights-data-ingestion-profile-construction - lesson 06 - Publishing Schema & Version Control - data-insights-data-ingestion-profile-construction lesson ### Indexing notes Index this lesson as a primary chunk tagged with lesson_id "06" and topics: [Publishing, Schema, Version, Control]. Parent course slug: data-insights-data-ingestion-profile-construction. 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: Publishing Schema & Version Control | `https://cdn.jwplayer.com/v2/media/PCj1HuBz/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/` |