About Personalize

Creating a Personalize Project and Experiences

Working with Attributes

Creating Audiences

Creating Events for A/B Tests

Adding Audiences to Experiences

Working with Entry Variants

A/B Testing an Audience Impersonation

In the&nbsp;Personalize Foundations&nbsp;course, you will explore the essentials of delivering tailored content to your audience through Contentstack's personalization features. The course covers the challenges of personalization, such as scalability and complexity, and presents a solution that balances simplicity and flexibility. You'll learn how to set up projects, configure segmented experiences, run A/B tests, and leverage attributes and audiences to deliver the right message at the right time. With practical guidance on creating dynamic user experiences, this course aims to improve engagement, conversions, and customer loyalty through effective personalization.

Learn the fundamentals of Contenstack Personalize

Opengraph_B.png

Personalize Foundations

personalize-foundations.png

Understanding Releases

Understanding Releases in Contentstack is critical when it comes to scheduling content publishing.

releases.jpg

<h2>A Foundation for Organized and Efficient Content Management</h2>In this module, we begin by defining&nbsp;<a href="https://www.contentstack.com/docs/developers/content-modeling">content modeling</a>&nbsp;and its&nbsp;significant benefits. Next, we will address the pitfalls of improper modeling and guide you through the necessary steps to ensure a sound content model to&nbsp;avoid&nbsp;common mistakes. Additionally, we will provide an overview of the core components involved in content creation;&nbsp;content types, assets, and entries.&nbsp; We close with a brief example of how to analyze your site or&nbsp;wireframe for effective modeling. By understanding the key concepts, following best practices, and implementing a well-structured content model, you can optimize your content management process and deliver a seamless user experience.<h2>What Is Content Modeling?</h2>Content modeling means defining the structure and organization of your content at&nbsp;a granular level.&nbsp;It involves identifying content types, their fields, and their relationships to create an optimized and reusable framework for managing and presenting content.&nbsp;If you have experience in database design, content modeling bears similarities. The goal of content modeling is to construct content types and structures that facilitate reuse, accommodate multiple channels, and are user-friendly for content contributors/editors. In <a href="https://www.contentstack.com/docs">Contentstack</a>, content modeling begins during the design stage and should be the first step in a successful project. Errors in content modeling can impact the structure of your web/app page. It is important to consult with your content team to validate the content model, review fields, and create entries using established content types. Some metadata fields may not be visible on a page, so the content team should help define them. Each section/component of your website or app should have a suitable content model that aligns with its actual content. <h2>Unlocking Success: The Vital Importance of Content Modeling for Structured, Reusable, and Efficient Content Management</h2> Content modeling is a vital aspect of successful content management. By structuring content, enabling reusability, and fostering efficient creation, it empowers content creators while enhancing user experiences. Its benefits include organized content, consistent presentation, streamlined workflows, and adaptability to future changes. Additionally, content modeling ensures seamless multichannel delivery, collaborative management, and effective SEO practices. Embracing content modeling sets a strong foundation for content governance and control, ensuring data integrity. Ultimately, content modeling is a strategic investment that propels digital content delivery to greater heights. Some of the key benefits include: <ul><li>Structured Content Organization:&nbsp;Content modeling helps organize content into structured and well-defined content types. Each content type represents a specific type of content with its own set of fields, ensuring consistency and easy categorization of content.</li><li>Reusability and Consistency:&nbsp;By defining content types and fields, content can be reused across multiple entries and pages. This reusability ensures consistent presentation and branding throughout the website or application.</li><li>Efficient Content Creation:&nbsp;Content modeling allows content editors to create content using predefined templates or blueprints. This speeds up content creation by providing a clear framework for entering content without the need to design the layout from scratch each time.</li><li>Flexibility and Scalability:&nbsp;Content modeling enables flexibility in managing different types of content, including text, images, videos, and other media. As the website or application grows, content modeling provides scalability to adapt and expand content types to meet changing needs.</li><li>Multichannel Content Delivery:&nbsp;With well-structured content, it becomes easier to deliver content to various channels and platforms, such as websites, mobile apps, voice assistants, or IoT devices. Content modeling helps separate content from presentation, making it adaptable to different channels.</li><li>Collaborative Content Management:&nbsp;Content modeling allows different teams or content contributors to work independently on their assigned content types. This division of content responsibilities facilitates collaborative content management and improves overall efficiency.</li><li>Easy Updates and Maintenance:&nbsp;When changes need to be made to the content, content modeling enables updates to be applied systematically across all relevant entries, reducing the chances of inconsistencies and errors.</li><li>SEO and Searchability:&nbsp;Well-structured content is more search engine-friendly, leading to improved SEO performance and better discoverability of content on the web.</li><li>Content Governance and Control:&nbsp;Content modeling allows content administrators to define content structures, fields, and access controls. This ensures proper content governance and maintains data integrity.</li><li>Future-Proofing:&nbsp;By modeling content in a structured manner, content remains adaptable to future changes and advancements in technology without requiring significant overhauls to the content management system.</li></ul><h2>The Perils of Improper Content Modeling: Avoiding Inconsistencies and Maximizing Efficiency</h2> Conversely, not modeling content properly can lead to several pitfalls and challenges in content management. Some of the key pitfalls include: <ul><li>Inconsistent Content:&nbsp;Without proper content modeling, there is a higher risk of inconsistent content presentation across the website or application. Inconsistent formatting, layout, and styling can create a disjointed user experience and negatively impact the brand's image.</li><li>Content Duplication:&nbsp;In the absence of structured content types, content creators may duplicate content manually across various pages or sections. This redundancy can lead to difficulties in managing updates, as changes need to be applied separately to each duplicated instance.</li><li>Data Integrity Issues:&nbsp;Improper content modeling may result in missing or incomplete data, leading to data integrity issues. This can adversely affect the accuracy and reliability of the information presented to users.</li><li>Difficult Content Updates:&nbsp;Without a well-defined content model, updating content becomes challenging. Content editors may struggle to find the right fields and sections to modify, leading to errors and inconsistencies in content updates.</li><li>Inefficient Workflow:&nbsp;Lack of content modeling can lead to inefficient content creation and approval workflows. Content contributors may face difficulties in understanding the content structure, resulting in delays and miscommunications.</li><li>Limited Reusability:&nbsp;Without structured content types, content reuse becomes limited. This means content creators may need to recreate similar content from scratch, wasting valuable time and effort.</li><li>Poor SEO Performance:&nbsp;Unstructured content can negatively impact search engine optimization (SEO) efforts. Search engines prefer well-organized content, and without proper modeling, search engines may struggle to interpret and rank the content correctly.</li><li>Scaling Challenges:&nbsp;As the website or application grows, managing unstructured content becomes more complex and difficult to scale. Scaling without proper content modeling can lead to an inconsistent user experience and management challenges.</li><li>Difficulty in Multichannel Delivery:&nbsp;Unstructured content may not be easily adaptable to different platforms and channels. This can hamper multichannel content delivery and diminish the brand's ability to reach a broader audience.</li><li>Limited Content Insights:&nbsp;Properly modeled content allows for better content analytics and insights. Without a structured content model, tracking and analyzing content performance may become limited or challenging.</li></ul> In summary, not modeling content properly can result in a host of issues, including inconsistent content, data integrity problems, inefficiencies in content workflows, and difficulties in scaling and managing content. To avoid these pitfalls, investing in content modeling is essential for a seamless and effective content management process.<h2>Is Your Content Model Sound? Steps for Effective Content Management</h2> Ensuring a sound content model is crucial for effective content management. Keep in mind that there is no single right way to build a model, but there are general best practices you can follow. Here are some steps to ensure your content model is well-structured and meets your requirements: <ul><li>Define Content Objectives:&nbsp;Clearly define the objectives of your content and understand the types of content you want to create and manage. Consider the different elements, data types, and relationships that need to be represented in your content.</li><li>Analyze Content Types:&nbsp;Identify the various types of content you will be working with (e.g., articles, products, events) and break them down into individual content types. Determine the fields and data structures needed for each content type.</li><li>Organize Content Fields:&nbsp;Group related fields together within each content type to create a cohesive and organized content model. This helps content creators understand how different pieces of information relate to each other.</li><li>Consider Content Relationships:&nbsp;Determine the relationships between different content types. For example, a blog post may be associated with an author, category, and tags. Use reference fields or modular blocks to establish these relationships.</li><li>Anticipate Future Needs:&nbsp;Design your content model to be flexible and scalable, accommodating future changes and additions. Consider potential content types or fields that may be required as your website or application grows.</li><li>Seek Feedback and Input:&nbsp;Involve content creators, editors, and stakeholders in the content modeling process. Gather feedback and input from the team to ensure the content model aligns with their needs and workflow.</li><li>Evaluate Content Solutions:&nbsp;Deciding between building or integrating an application is crucial in content modeling. While common third-party solutions like DAM or e-commerce vendors offer standardized features, bespoke functionality ensures tailored efficiency and adaptability, impacting content management's future scalability.</li><li>Test Content Creation and Management:&nbsp;Create test entries and content to ensure that the content model functions as expected. Validate that the content can be easily created, edited, and managed within the defined content types.</li><li>Address Performance and SEO:&nbsp;Consider how your content model may impact website performance and search engine optimization. Optimize your content model to ensure fast loading times and SEO-friendly content structure.</li><li>Document Your Content Model:&nbsp;Create comprehensive documentation for your content model, including content type definitions, field descriptions, and content relationships. This documentation will serve as a reference for content creators and developers.</li><li>Iterate and Refine:&nbsp;Content modeling is an iterative process. Continuously gather feedback, monitor content performance, and make adjustments to your content model as needed to improve its effectiveness.</li></ul> By following these steps and regularly reviewing your content model, you can ensure that your content is well-structured, easily manageable, and aligned with your content objectives and business goals. A sound content model sets the foundation for successful content management and helps deliver a seamless and consistent user experience.<h2>Module Summary:&nbsp;&nbsp;The Essential Importance of Content Modeling</h2> Content modeling involves defining the structure and organization of content, facilitating efficient content management and presentation. It empowers content creators, enhances user experiences, and enables multichannel delivery. Proper content modeling offers benefits such as organized content, consistent presentation, streamlined workflows, and adaptability to future changes.Improper content modeling can lead to pitfalls like inconsistent content, duplication, data integrity issues, and scalability challenges. Effective content management requires defining objectives, analyzing content types, organizing fields, considering relationships, anticipating needs, seeking feedback, testing, addressing performance and SEO, and documenting the model.Contentstack's foundational components are Content Types, Entries, and Assets, which structure content and facilitate its management and delivery. Content modeling is a strategic investment that ensures successful content governance and propels digital content delivery across platforms. Learn more:<ul><li><a href="https://www.contentstack.com/docs/developers/content-modeling/about-content-modeling">Content Modeling</a></li><li><a href="https://www.contentstack.com/docs/developers/content-modeling/content-modeling-best-practices">Content Modeling Best Practices</a></li></ul>

Understanding Content Modeling

Core Content Structures

Publishing Environments

Boolean, Date, File, and Number Fields

Reference Fields

Select Fields

In this lesson, we explore the advantages and scenarios of using Contentstack's <a href="https://www.contentstack.com/docs/developers/create-content-types/rich-text-editor">HTML RTE (Rich Text Editor)</a>. The HTML RTE empowers content creators with enhanced formatting options and flexibility to embed multimedia elements, creating engaging content. Its customization capabilities allow tailored content creation, while seamless code integration enables dynamic features. We also examine common pitfalls, including formatting discrepancies and security risks. To overcome challenges, we present best practices, including user training, content governance, accessibility compliance, and performance optimization. By leveraging the HTML RTE effectively, content creators and developers can craft compelling and consistent content experiences for diverse digital platforms. <img src="https://learnupon.s3.eu-west-1.amazonaws.com/645026/original/2c547a65-816e-42ce-8fc7-d8b81b3d15d5-html_Medium.png" width="100"/><h2>Exploring the Capabilities of Contentstack's HTML RTE</h2> From enhanced formatting options and seamless code integration to accessibility and SEO benefits, we will discover how this powerful tool elevates content creation for responsive and user-engaging experiences across various platforms. <img src="https://learnupon.s3.eu-west-1.amazonaws.com/645024/original/270f31cf-4307-41db-8fdc-edadfaa2b732-Screenshot_2023-08-17_at_4.10.17_PM.png" width="100"/>Contentstack's HTML RTE&nbsp;offers a range of advantages for content creators and developers:<ul><li>Enhanced Formatting: The HTML RTE enables users to apply rich formatting options like bold, italics, headings, lists, and more, enhancing content presentation.</li><li>Flexibility: With HTML, users can effortlessly embed multimedia elements, such as images, videos, and interactive components, elevating user engagement.</li><li>Customization: The HTML RTE allows for advanced customization, empowering users to create bespoke content tailored to their specific requirements.</li><li>Seamless Code Integration: Developers can easily integrate custom code snippets and scripts to add interactive elements or dynamic features to the content.</li><li>Accessibility: HTML content is generally more accessible to assistive technologies, ensuring a better experience for users with disabilities.</li><li>Responsive Design: The HTML RTE facilitates the creation of responsive content, ensuring optimal viewing across different devices and screen sizes.</li><li>SEO-Friendly: Properly structured HTML content can enhance search engine visibility, contributing to better search rankings.</li><li>Cross-Browser Compatibility: HTML content is widely supported across various web browsers, ensuring consistent performance and display.</li><li>Version Control: Contentstack's HTML RTE often includes version control features, enabling users to track changes and revert to previous versions as needed.</li><li>Future-Proofing: HTML is a standard language for the web, making it a reliable and future-proof choice for content creation.</li></ul>In conclusion, Contentstack's HTML RTE empowers users with the flexibility and functionality needed to create engaging and dynamic content for diverse digital platforms.*Note: Always be cautious when allowing custom HTML input to avoid potential security risks and ensure content consistency.<h2>Creative Applications of Contentstack's HTML RTE</h2> Let's explore the diverse applications of Contentstack's HTML RTE (Rich Text Editor). From content creation and email campaigns to landing pages, user documentation, and interactive content, we discover how this versatile tool is utilized across various scenarios for crafting visually appealing and engaging content. <img src="https://learnupon.s3.eu-west-1.amazonaws.com/645025/original/6f175aed-4080-4aca-a2b8-6b2358f0e2f8-html-rte.png" width="100"/> Some common scenarios where Contentstack's HTML RTE&nbsp; are commonly used: <ul><li>Content Creation: Authors and content creators use the HTML RTE to draft and format blog posts, articles, product descriptions, and other web content.</li><li>Email Campaigns: Marketing teams leverage the HTML RTE to design and customize email newsletters, ensuring visually appealing and engaging content.</li><li>Landing Pages: Web developers and marketers use the HTML RTE to create captivating landing pages with rich media and interactive elements.</li><li>User Documentation: Technical writers utilize the HTML RTE to create and format user guides, manuals, and documentation with images, code snippets, and more.</li><li>Knowledge Base Articles: Customer support teams use the HTML RTE to craft comprehensive and visually enhanced knowledge base articles for self-help resources.</li><li>Social Media Posts: Content marketers format and style social media posts using the HTML RTE to make them stand out and capture users' attention.</li><li>Press Releases: PR professionals use the HTML RTE to format press releases with headings, bullet points, and multimedia elements.</li><li>Web Page Content: Web developers and content creators use the HTML RTE to manage and update the content of various web pages on their websites.</li><li>Announcements and Notices: Organizations use the HTML RTE to create visually appealing announcements, event notices, and news updates for their audiences.</li><li>Interactive Content: Developers integrate custom JavaScript or other scripts using the HTML RTE to create interactive elements such as quizzes, surveys, or calculators.</li></ul>These are just a few examples of how Contentstack's HTML RTE and similar Rich Text Editors are utilized in various scenarios to create and manage content across different digital platforms.<h2>Common Challenges&nbsp;of the HTML RTE&nbsp;</h2> While using HTML RTE (Rich Text Editor) offers numerous benefits, it can also present some challenges and issues that content creators and developers need to be aware of. Observe these typical setbacks faced when using the HTML RTE: <ul><li>Content Formatting Discrepancies: Different web browsers and email clients may interpret HTML formatting differently, leading to inconsistencies in how the content appears to end-users.</li><li>Security Risks: Allowing users to input custom HTML can create security vulnerabilities, such as cross-site scripting (XSS) attacks, if not properly sanitized and validated.</li><li>Complexity for Non-Technical Users: The flexibility of the HTML RTE can be overwhelming for non-technical content creators, leading to difficulties in using and formatting content correctly.</li><li>Content Fragility: Directly embedding custom HTML code can make the content more fragile, as small syntax errors can cause content failures or improper rendering.</li><li>Accessibility Concerns: Improperly structured HTML content can hinder accessibility for users with disabilities, leading to compliance issues with accessibility standards.</li><li>Performance Impact: Excessive use of complex HTML elements and scripts can negatively impact page load times and overall website performance.</li><li>Version Control Challenges: Versioning HTML content can be more complex, especially when updating specific components within the content.</li><li>Cross-Browser Compatibility: Ensuring consistent rendering and functionality across different web browsers can be challenging due to varying browser support for HTML features.</li><li>Data Integrity: If users have the ability to input raw HTML, there is a risk of improperly formatted code that may affect the data integrity of the content.</li><li>Content Governance: Allowing extensive customization with HTML RTE might lead to inconsistencies and deviations from the brand's style guidelines.</li><li>Limited WYSIWYG Editing: HTML RTE might lack certain visual editing features present in traditional WYSIWYG editors, making it challenging for users to visualize content changes in real-time.</li></ul> In this lesson, we explored challenges of using the HTML RTE (Rich Text Editor), including content formatting discrepancies, security risks, complexity for non-technical users, accessibility concerns, performance impact, and issues with version control and cross-browser compatibility.<h2>Effective Use of the HTML RTE Field</h2> Essential strategies for harnessing the full potential of HTML RTE&nbsp; include user training and input validation to accessibility compliance and performance optimization. Below we will&nbsp;discover how to create consistent, secure, and engaging content while mitigating common challenges. Here are some strategies and best practices to overcome such challenges.: <ul><li>User Training and Support: Provide comprehensive training and documentation for non-technical users on how to use the HTML RTE effectively and safely. Offer ongoing support to address any questions or difficulties they may encounter.</li><li>Input Sanitization and Validation: Implement strict input sanitization and validation to prevent security vulnerabilities like XSS attacks. Use a robust HTML sanitizer to ensure only safe and allowed tags and attributes are used.</li><li>Content Governance and Style Guidelines: Establish clear content governance policies and style guidelines to maintain consistency and adherence to the brand's visual identity and formatting standards.</li><li>Use of Templates and Components: Utilize predefined templates and reusable components to streamline content creation, ensuring consistent styling and structure across different pages.</li><li>Accessibility Compliance: Follow web accessibility guidelines (e.g., WCAG) to ensure HTML content is accessible to all users, including those with disabilities.</li><li>Content Versioning and Review Process: Implement a version control system and review process to track changes and maintain content integrity while collaborating with multiple stakeholders.</li><li>Performance Optimization: Optimize HTML code and scripts to improve page load times and overall website performance. Minimize unnecessary elements and prioritize performance.</li><li>Browser Testing: Regularly test the HTML content across various web browsers and devices to ensure consistent rendering and functionality.</li><li>Automated Testing: Employ automated testing tools to identify potential issues, such as broken links, missing tags, or performance bottlenecks in the HTML content.</li><li>Limit Customization Options: If appropriate, limit the extent of HTML customization available to content creators, balancing flexibility with the need for consistency and security.</li><li>Debugging and Error Handling: Develop robust error-handling mechanisms to detect and address syntax errors and content failures effectively.</li><li>Collaboration and Communication: Foster open communication and collaboration between content creators, developers, and other stakeholders to address challenges and find optimal solutions together. </li></ul>In summary, organizations should implement proper content governance, security measures, and user training to mitigate issues. Additionally, leveraging templates and predefined styles can help create consistent and secure content. Regular audits and testing across various browsers and devices can also help identify and address potential rendering discrepancies and performance concerns.Walkthrough Lesson: Integrating an HTML RTE Field to the "News Article" Content Type in Contentstack<div style="position: relative;overflow: hidden;padding-bottom: 56.25%;"><iframe src="https://cdn.jwplayer.com/players/pPkRXW33-b769H14u.html" width="100%" height="100%" frameborder="0" scrolling="auto" title="Cm-implementing Html Rte" style="position: absolute;" allowfullscreen=""></iframe></div>Objective: Equip yourself with the knowledge to incorporate the HTML RTE (Rich Text Editor) field into a Contentstack "News Article" content type, thereby enhancing the visual appeal and interactivity of news articles. Step 1: Introduction to HTML RTE<ul><li>Kick off with an overview of the Rich Text Editor (RTE) in Contentstack and its pivotal role in transforming traditional news articles into immersive multimedia experiences.</li></ul>Step 2: Scenario Setup<ul><li>Scenario: Imagine you're the digital editor for "Daily Insights," a news portal. While your articles are informative, they lack visual elements and interactive content, leading to decreased reader engagement. To address this, you decide to revamp the "News Article" content type by integrating rich text capabilities, allowing journalists to embed images, videos, and utilize advanced text formatting.</li></ul>Step 3: Accessing Your "News Article" Content Type<ul><li>Log into your Contentstack account.</li><li>Head over to the "Content Models" section.</li><li>Find and select the "News Article" content type.
 </li></ul>Step 4: Incorporating the HTML RTE Field<ul><li>Tap on the "+ Add Field" button.</li><li>From the dropdown menu, opt for "Rich Text Editor."</li><li>Name the field "Article Content" or something similar.</li><li>Optionally, provide a brief guideline for journalists, such as "Craft the core content of the article, embedding relevant images, videos, and using rich text formatting for better reader engagement."</li></ul>Step 5: Tailoring the HTML RTE<ul><li>Within "Properties," select the formatting tools that align with your portal's style guide.</li><li>Set validation rules if needed, like ensuring certain tags are used or setting a character limit for consistency.
 </li></ul>Step 6: Save and Test<ul><li>Click "Save" to finalize the HTML RTE field's addition to your "News Article" content type.</li><li>Navigate to the "Entries" section and pick "News Article."</li><li>Create a new entry or edit an existing one. You should now spot the "Article Content" field, equipped with the rich text editor toolbar.</li><li>Test its functionality by drafting a sample news piece, embedding multimedia elements, and experimenting with different formatting tools.</li></ul>Step 7: Conclusion<ul><li>By seamlessly integrating the HTML RTE field into your "News Article" content type, you've empowered your journalists to craft compelling, multimedia-rich articles, ensuring that "Daily Insights" offers a modern and engaging reading experience.</li></ul>Note: For comprehensive details and any updates related to the HTML RTE functionalities, it's advisable to refer to the&nbsp;<a href="https://www.contentstack.com/docs/developers/create-content-types/rich-text-editor">documentation</a>.<h2>Module Summary:&nbsp;Optimizing&nbsp;HTML RTE Field Implementation</h2>
 In this comprehensive lesson, we explored the versatility of Contentstack's HTML RTE and its advantages for content creators. We delved into common scenarios where HTML RTE is widely used, from content creation to interactive elements. However, challenges, such as formatting discrepancies and security risks, should not be overlooked. To overcome these hurdles, we presented best practices like user training, input validation, and accessibility compliance. By adhering to content governance and collaborating effectively, content creators can elevate their work, ensuring consistent and engaging experiences for users across digital platforms. Learn more:<ul><li><a href="https://www.contentstack.com/docs/developers/json-rich-text-editor/html-rte-vs-json-rte">HTML RTE vs JSON RTE</a></li></ul><h2>Optional Exercise: Implementing the HTML RTE in 'Product Listing' Content Type&nbsp;
 </h2>Objective: Learn how to integrate the HTML RTE (Rich Text Editor) into the 'Product Listing' content type to enhance content creation and formatting capabilities. Scenario: You're managing an online store's content on Contentstack. To provide detailed descriptions for products, you decide to implement the HTML RTE, allowing for rich text formatting and embedding of multimedia elements.
 Step 1: Accessing the 'Product Listing' Content Type<ul><li>Navigate to your Contentstack dashboard.</li><li>Locate and select the existing 'Product Listing' content type.</li></ul> Step 2: Integrating the HTML RTE to 'Product Listing'<ul><li>Click on "+ Add Field" and select the "Rich Text Editor" field.</li><li>Label it "Product Details".</li><li>In the properties section, enable the "Allow HTML" option to utilize the HTML RTE capabilities.</li><li>Save the changes to the 'Product Listing' content type.
 </li></ul>Step 3: Creating or Editing Entries with HTML RTE<ul><li>Navigate to the 'Entries' section and select 'Product Listing'.</li><li>Click on "+ New Entry" or select an existing entry to edit.</li><li>In the "Product Details" field, you can now utilize the HTML RTE to format text, embed multimedia, and input custom HTML.</li><li>Save and publish the entry.</li></ul> Conclusion: By integrating the HTML RTE into the 'Product Listing' content type, you've empowered content creators with enhanced text formatting and multimedia embedding capabilities. This ensures richer and more engaging content for your online store's audience.

HTML RTE Field

Group Fields

Global Fields

Custom Fields

Modular Blocks

Languages & Localization

The Contentstack Content Models are a blueprint or schema of a content type that defines the structure, fields, and relationships of the content. It is a visual representation of the content type and helps content editors and developers to create and manage content in a structured and organized manner. If you haven't already installed a training instance, you can do so by visiting our Legacy Academy. Click the <a href="https://www.contentstack.com/academy-old">Create Training Instance</a> button on the home page.

This course provides you the necessary information to effectively content model within the Contentstack CMS.

Opengraph_A.png

Content Modeling with Contentstack

content-modeling-cs.png

<h1>Developer Onboarding Course - Introduction</h1> Welcome to our exciting new course on developing web applications with Contentstack! If you're looking to build powerful, scalable, and customizable web applications, then you're in the right place. In this course, we'll guide you through the fundamentals of Contentstack, including content modeling, API and SDK usage, and more. We'll also cover advanced topics such as extending a NextJS app, enabling localization, and optimizing your content delivery. With our easy-to-follow tutorials and hands-on exercises, you'll quickly gain the skills and knowledge needed to build stunning web applications that meet the needs of your clients and users. So, whether you're a seasoned developer or just starting out, join us on this exciting journey and take your web development skills to the next level with Contentstack!The main tasks in the course are:<ol><li>Create a new detail page (new content type, new NextJS Component, new CD API query)</li><li>Create a new gallery landing page (new content type, new NextJS Component, more complicated CD API Queries)</li></ol>We also cover the following:<ul><li>Starter app overview, install, and walk through</li><li>Using CMA to read and import content</li><li>SDKs / APIs overview and introduction</li><li>SDKs / APIs deep dive with patterns / practices&nbsp;</li><li>Roles &amp; Permissions</li><li>Workflow</li><li>Marketplace intro</li><li>Automation hub intro</li></ul><h1>What we will be building</h1><h2>Composable Hero&nbsp;Gallery Page</h2><img src="https://images.contentstack.io/v3/assets/bltebc53cfaf0dd6403/bltd51a0c5b982c72f8/664c027a1983ea9d6dac29b4/composable-heros.png" alt="composable-heros.png" height="auto"/><h4> Composable Hero Detail Page</h4><img src="https://images.contentstack.io/v3/assets/bltebc53cfaf0dd6403/bltcba8639d82e39f82/664c02a3785339639e9e3d9f/composable-heros-detail.png" width="auto" alt="composable-heros-detail.png" height="auto" max-width="auto" style="max-width: auto;width: auto;height: auto;"/><h1>Getting Started</h1>1.&nbsp; Create a new Training Instance - Go to&nbsp;<a href="https://www.contentstack.com/academy-old">https://www.contentstack.com/academy-old</a> and select 'Create a Training Instance'. 2.&nbsp; <a href="https://github.com/contentstack/contentstack-academy-playground">Download the course code from Github (https://github.com/contentstack/contentstack-academy-playground)</a> 3.&nbsp; Rename the .env.local.sample file to .env.local and update the configuration properties <img src="https://images.contentstack.io/v3/assets/bltebc53cfaf0dd6403/bltb3b6b76e3ee547ed/664c033cc9024cafa4ad58b4/rename-sample.png" alt="rename-sample.png" height="auto"/> 4. Build the project with 'npm i' 5.&nbsp; Run the website with 'npm run dev'

What We'll Build

Getting Started

<h1>Architecture</h1><h2>Big Picture Architecture Diagram</h2><h3>Backend</h3>The Backend of Contentstack is the CMS with the ability to create and publish content.&nbsp; The focus here is on editor ease-of-use by providing a simple, powerful and flexible UI for content creation and management.&nbsp; In addition to the out of the box functionality, we also provide an ability to extend the interface by creating UI Extensions using our App SDK and connect to 3rd-party applications such as DAM providers, Analytics, E-Commerce platforms and more.<h3>Frontend</h3>The focus on the frontend is high-performance for your website and web application. APIs and SDKs are provided to the developer for using in their applications to perform read-only queries to the content.&nbsp; The Content Delivery APIs use an internal CDN to cache all queries to the platform which results in higher performance for all your web applications.&nbsp; This is also where we find the Images API for delivering image assets.<img src="https://images.contentstack.io/v3/assets/bltebc53cfaf0dd6403/blt40df19fbdfa691c4/664c7d55a671fa7891f218bf/Architecture.png" alt="Architecture.png" height="auto"/><h2>Environments</h2><ul><li>One Stack can publish to multiple Environments. &nbsp;Think of Environments as “publish destinations”.</li><li>Each Environment has one Delivery Token, otherwise known as an Access Token. &nbsp;That token is unique per Environment.</li><li>Each Stack has an API key. &nbsp;There is only 1 API key per Stack and it is unique.</li><li>Most API calls will require both an API token and a Delivery / Access Token.</li></ul><img src="https://images.contentstack.io/v3/assets/bltebc53cfaf0dd6403/blta9f0e57d8a3c5a6e/664c7d9f79abee8ebd3d1534/environment.png" alt="environment.png" height="auto"/>Multi-Stack Architecture Diagram<img src="https://images.contentstack.io/v3/assets/bltebc53cfaf0dd6403/bltd1dd48a1fcbec491/664c7de28a66292552b1397b/multi-stack.png" alt="multi-stack.png" height="auto"/>

Big Picture Architecture

Architecture Walkthrough

Environments Walkthrough

In this module, we'll dive into the world of Contentstack's powerful APIs that can help you build your digital experiences faster, easier, and better. Our APIs are designed to help developers access content and make updates programatically.First, we'll start with Contentstack's Content Delivery API. This API allows developers to retrieve content from Contentstack's headless CMS and deliver it to any digital platform or device. You'll learn how to use our API to retrieve content in a structured and organized manner, so you can easily integrate it into your website, app, or any other digital platform.Next, we'll explore Contentstack's Content Management API. This API enables developers to create, update, and manage content in Contentstack's headless CMS programmatically. You'll learn how to leverage our API to automate content creation, content management workflows, and enable seamless collaboration between developers and content editors, and increase the efficiency of your content creation processes.Finally, we'll dive into Contentstack's Images API. This API allows you to transform and optimize images on-the-fly, so you can deliver the best possible visual experience to your users. You'll learn how to use our API to resize, compress, and optimize images.By the end of this module, you'll have a deep understanding of Contentstack's powerful APIs and how to leverage them to build faster, better, and more engaging digital experiences. So, let's get started!<h1>Using the Content Delivery API</h1>Contentstack's Content Delivery API is a powerful tool that enables developers to retrieve content from Contentstack's headless CMS and deliver it to any digital platform or device. It allows you to fetch content in a structured and organized manner, which makes it easier to integrate into your website, app, or any other digital platform.The Content Delivery API is built on top of a powerful caching layer, which ensures lightning-fast performance even when you're dealing with large amounts of content. This caching layer also ensures that your content is always up-to-date and in sync with the latest updates made to the CMS.One of the biggest advantages of using Contentstack's Content Delivery API is that it's completely agnostic to the technology stack you're using. Whether you're building your website using a traditional CMS or a modern front-end framework like React or Vue.js, the Content Delivery API can be seamlessly integrated into your workflow.With the Content Delivery API, you can also retrieve content in multiple languages, which is essential for building global websites and apps. The API also allows you to fetch only the content you need, which reduces the amount of data transfer and improves the overall performance of your application.<a href="https://www.contentstack.com/docs/developers/apis/content-delivery-api/">Content Delivery API Documentation</a><img src="https://images.contentstack.io/v3/assets/bltebc53cfaf0dd6403/bltbeecb6f7ab8cf28a/664d437c785339c0e89e4f8e/API-map.png" alt="API-map.png" height="auto"/>

Using the Content Delivery API

<h3>Using the&nbsp;Content Delivery API documentation </h3><ol><li>Go to the <a href="https://www.contentstack.com/docs/developers/apis/content-delivery-api/#get-all-entries">Get Entries section of the Content Delivery Documentation</a></li><li>Select the Get all Entries link to open the query window on the right</li><li>Update the parameters to use the following:
 - content_type_uid: blog_post
 - environment: preview (or development)
 - locale: en-us
 - api_key: (found in the settings / tokens / content delivery token settings page)
 - access_token:&nbsp;(found in the settings / tokens / content delivery token settings page)

 <a href="https://www.contentstack.com/docs/developers/apis/graphql-content-delivery-api/#postman-collection">If you have questions, see the Postman guide for more details</a></li><li>Execute the request with the 'Try' button</li><li>Congrats!&nbsp; you just queried the Contentstack Content Delivery API!</li></ol>

Using the Content Delivery API documentation

Querying the Content Delivery API with the Documentation Walkthrough

<h3>Using the Postman collection to connect with the Content Delivery API</h3><ol><li><a href="https://www.postman.com/downloads/">Download and install Postman</a></li><li><a href="https://www.contentstack.com/docs/developers/apis/postman-collections">Download the Contentstack Postman Content Delivery collection</a></li><li>To obtain the Content Delivery Token, follow these steps in Contentstack: navigate to the "Settings" page, select "Tokens," then choose "Content Delivery." If you haven't created a Delivery Token yet, <a href="https://www.contentstack.com/docs/developers/create-tokens/create-a-delivery-token/">create a new Delivery Token</a>. <a href="https://www.contentstack.com/docs/developers/create-tokens/#work-with-delivery-tokens">Additional information about tokens, including Delivery Tokens, can be found in our documentation</a>&nbsp;</li><li>Open Postman and select the 'Content Delivery API - Contentstack' collection.&nbsp; Entries, Get all entries</li><li>Edit the Postman variables and update the values for api_key and access_token.&nbsp; The api_key is found on the Delivery Token settings page.&nbsp; The access_token is the Delivery Token.&nbsp; These are used in the Headers of the request.
 Also, add the value of the content_type_uid as 'blog_post', environment as 'preview' and locale as 'en-us'.</li><li>Send the request.&nbsp; Contentstack replies&nbsp;with the JSON of all blog_post entries.</li></ol>

Using the Postman collection to connect with the Content Delivery API

Using Postman to query the Contentstack Content Delivery API Walkthrough

<h2>Getting Started using the JavaScript Content Delivery SDK</h2>To get started with the Content Delivery SDK and NodeJS, the first thing you need to do is to install it. You can do this by running the following command in your project directory:npm install contentstack <h2>Helpful Javascript Resources</h2><a href="https://github.com/contentstack/contentstack-javascript">Javascript SDK on Github</a>&nbsp;<a href="https://www.contentstack.com/docs/developers/sdks/content-delivery-sdk/javascript-browser/reference/">Javascript API Reference</a>
 Include the JS SDK in your projects<pre>https://cdn.jsdelivr.net/npm/contentstack@latest/dist/web/contentstack.min.js </pre>Once you have installed the SDK, you need to initialize it with your API key, delivery token, and environment name. Here's an example of how to do this:<pre>const Contentstack = require('contentstack'); const Stack = Contentstack.Stack({ api_key: 'your_api_key', delivery_token: 'your_delivery_token', environment: 'your_environment' }); </pre>With the SDK initialized, you can start retrieving content from Contentstack's API. The SDK provides several methods for fetching content, depending on your requirements.If you want to retrieve a single entry, you can use the Entry method, as shown in the following example:<pre>Stack.ContentType('your_content_type_uid').Entry('your_entry_uid').fetch() .then(function success(entry) { console.log(entry); }, function error(err) { console.log(err); }); </pre>In this example, your_content_type_uid is the unique identifier of the content type you want to retrieve, and your_entry_uid is the unique identifier of the entry you want to retrieve. The fetch() method retrieves the entry and returns it as a JavaScript object.If you want to retrieve multiple entries, you can use the Query method, as shown in the following example:<pre>const stack = Contentstack.Stack({"api_key":"bltc2242b759e36fcb9","delivery_token":"cs1470a664abc4563bd43a604d","environment":"development"});&nbsp; // use your api_key and delivery_token here from your Stack const query = stack.GetEntry('blog_post').Query(); query.toJSON() &nbsp; .find() &nbsp; .then( &nbsp; (result) =&gt; { &nbsp; &nbsp; console.log(result[0]); &nbsp; }, &nbsp; (error) =&gt; { &nbsp; &nbsp; console.error(error); &nbsp; }, ); </pre>In this example, your_content_type_uid is the unique identifier of the content type you want to retrieve. The find() method retrieves all the entries of the content type and returns them as an array of JavaScript objects.The SDK also provides methods for filtering and sorting entries, as well as retrieving entries with specific fields. You can learn more about these methods in the Contentstack documentation.There are also SDKs for most popular languages such as .Net, Java, PHP, Python, Ruby, iOS, Android, Dart, etc.Documentation links:<ul><li><a href="https://www.contentstack.com/docs/developers/sdks/content-delivery-sdk/javascript-browser/reference/">API Reference</a></li><li><a href="https://github.com/contentstack/contentstack-javascript">JavaScript SDK Github Repo</a></li><li><a href="https://www.contentstack.com/docs/developers/sdks/">All SDKs</a></li><li><a href="https://www.contentstack.com/docs/developers/web-framework/querying/">Query examples</a>
 </li></ul><img src="https://images.contentstack.io/v3/assets/bltebc53cfaf0dd6403/blt31c71c762d48a421/664d45aa79abeeeb093d23a5/content-sdk.png" alt="content-sdk.png" height="auto"/>

Using the JavaScript Content Delivery SDK

<h2>Using the GraphQL API with Postman</h2> <h3>GraphQL</h3>Contentstack's GraphQL API is a powerful tool for developers who want to integrate Contentstack's content management system (CMS) into their web or mobile applications. It provides a flexible and efficient way to retrieve content from Contentstack's content repository using the GraphQL query language.With Contentstack's GraphQL API, developers can retrieve content from their Contentstack projects using a single API call. The API returns only the data that is requested, which reduces the amount of data transferred and improves performance. The API also supports pagination, filtering, and sorting, which enables developers to retrieve only the content they need and to organize it in a way that best suits their application.Contentstack's GraphQL API supports all of the content types and fields defined in a Contentstack project, including modular blocks and assets. This means that developers can retrieve any type of content from Contentstack, including text, images, videos, and more.In addition, Contentstack's GraphQL API is designed to work seamlessly with popular frontend frameworks and libraries, such as React, Vue.js, and Angular. This allows developers to easily integrate Contentstack's content into their applications and to build dynamic and engaging user experiences.
 <h3>GraphQL API Explorer</h3>Contentstack has a GraphQL API explorer to query Contentstack's Content Delivery API.&nbsp;&nbsp;<img src="https://images.contentstack.io/v3/assets/bltebc53cfaf0dd6403/blt720a9df15d2b3c95/664d46208a0182e22014ca07/graphQL.png" alt="graphQL.png" height="auto"/><ol><li>In the Contentstack UI, navigate to Settings and then GraphQL</li><li>Build your queries</li><li>There is also an <a href="https://www.contentstack.com/docs/developers/graphql-api/use-the-graphql-queries-with-apollo-sdks/use-graphql-queries-with-apollo-client-javascript-sdk/">Apollo Client JavaScript SDK</a>&nbsp;for using the API&nbsp;</li></ol><h2>More GraphQL API Resources</h2><ul><li><a href="https://www.contentstack.com/docs/developers/apis/postman-collections/">GraphQL&nbsp;Postman Collection</a></li><li><a href="https://www.contentstack.com/docs/developers/graphql-api/graphql-sample-apps/">GraphQL Sample Apps</a></li><li><a href="https://www.contentstack.com/docs/developers/graphql-api/use-the-graphql-queries-with-apollo-sdks/use-graphql-queries-with-apollo-client-javascript-sdk/">Using GraphQL with the Apollo Client JavaScript SDK</a></li></ul>

Using the GraphQL API with Postman

<h1>CDN and Caching</h1>A Content Delivery Network (CDN) ensures that a cache of your content is stored at various locations around the globe. Consequently, whenever there is a page request, the content is served from the cache of the nearest CDN server, rather than the origin server ensuring quicker content delivery.<h2>How CDN Cache Works in Contentstack</h2>The CDN is always up-to-date. It ensures that the cache is always fresh through purging old data and caching new data.When any user requests a piece of content, the nearest CDN server checks if it has a cached copy of the requested content. If not, it checks with the shield server. And, if the shield server does not have the cache of the requested content, it fetches the content from the origin server.A shield server is an extra layer of caching that reduces the load on the origin server. It is located near the origin server, and it saves the cache of content that it serves to any CDN server. So, if any other CDN server requests the same data, the shield server would serve the cached content.Contentstack automatically purges content from the internal Contentstack CDN when published.&nbsp;&nbsp;Helpful links:<ul><li><a href="https://www.contentstack.com/docs/developers/cdn-and-caching/contentstack-cdn-cache-management/">How CDN Cache Management works in Contentstack</a></li></ul>

CDN and Caching

<h1>Query Examples with the Content Delivery API</h1><h2>Query by URL</h2><pre>const getContentByURL = async ({ contentType, slug, refUids, locale, filter }) =&gt; { try { const Query = global.Stack .ContentType(contentType) .Query() .language(locale) if (refUids) { let refs = refUids.replace(/ /g, '').split(',') Query.includeReference(refs) } let result = await Query .includeFallback() .where('url', `/${slug}`) .toJSON() .includeEmbeddedItems() .addParam('include_metadata', 'true') .find() if (result &amp;&amp; result.length &gt; 0 &amp;&amp; result[0].length &lt;= 0) { // for trailing slash match result = await Query .includeFallback() .where('url', `/${slug}/`) .toJSON() .includeEmbeddedItems() .addParam('include_metadata', 'true') .find() } (global.env === 'preview' || global.env === 'staging-preview' ||global.env === 'development') ? Contentstack.Utils.addEditableTags(result[0][0], contentType, true, locale) : '' //metadata key required for _metadata in cms entry data if(result.length &gt; 0 &amp;&amp; result[0].length &gt; 0) { result[0][0] = {...result[0][0], metadata: result[0][0]} } if (result) return result[0][0] } catch (error) { throw new Error(error) } }</pre> <h2>Query by UID</h2><pre>const getContentByUID= async ({ contentType, entryUid, refUids, locale }) =&gt; { try { const Query = global.Stack .ContentType(contentType) .Entry(entryUid) .language(locale) .includeFallback() .includeEmbeddedItems() if (refUids) { let refs = refUids.replace(/ /g, '').split(',') Query.includeReference(refs) } let result = await Query.toJSON().fetch() if (result) return result } catch (error) { return error } }</pre> <h2>Example to Get All Entries</h2><pre>const getEntries = async ({ contentType, refUids, locale }) =&gt; { let collectionData try { const Query = global.Stack.ContentType(contentType) .Query() .language(locale) if (refUids) { let refs = refUids.replace(/ /g, '').split(',') Query.includeReference(refs) } let result = await Query .includeFallback() .toJSON() .includeEmbeddedItems() .addParam('include_metadata', 'true') .find() if (result &amp;&amp; result.length &gt; 0 &amp;&amp; result[0].length &lt;= 1) { //for entry type = single (global.env === 'preview' || global.env === 'staging-preview' || global.env === 'development') ? Contentstack.Utils.addEditableTags(result[0][0], contentType, true, locale) : '' //metadata key required for _metadata in cms entry data result[0][0] = {...result[0][0], metadata: result[0][0]} return result[0][0] } //for entry type = multiple (global.env === 'preview' || global.env === 'staging-preview' || global.env === 'development') ? Contentstack.Utils.addEditableTags(result[0][0], contentType, true, locale) : '' if (result) return result } catch (error) { res.status(500).send(`Internal Server Error\n: ${error}`) // throw new Error(error) } }</pre>

Query Examples with the Content Delivery API

<h1>Using the Contentstack Images API</h1>Welcome, developers, to the Contentstack Images API! As you may know, images are an integral part of any digital experience, and we understand the importance of delivering optimized images quickly and efficiently. That's why we've created the Contentstack Images API, a powerful tool that allows you to manipulate, optimize, and deliver images to your web and mobile applications. Whether you're new to the platform or a seasoned developer, this guide will provide you with everything you need to know to get started with the Contentstack Images API. So let's dive in and explore the possibilities of this powerful tool together!Here are three advantages to using the Contentstack Images API:<ol><li>Performance: The Contentstack Images API allows you to deliver optimized images at scale, reducing load times and improving the overall performance of your web and mobile applications.</li><li>lexibility: With the Contentstack Images API, you have the flexibility to resize, and transform images in real-time, giving you the ability to customize images to fit any layout or design.</li></ol><h1>Trying out the Image Delivery API</h1>The quickest way to get started with the Image Delivery API is to try it out with the <a href="https://www.contentstack.com/docs/developers/apis/image-delivery-api/#introduction">online documentation</a>.&nbsp;&nbsp;Resize an image on the flyContentstack's Images API resizes images on the server and provides the resized file in the response.&nbsp; This is highly performant as the resized image is stored in the CDN cache on the Contentstack side.<h2></h2><h2>Exercise:&nbsp; Resize an image with the Contentstack Images API</h2>1. Go to the following URL, <a href="https://www.contentstack.com/docs/developers/apis/image-delivery-api/#resize-images">https://www.contentstack.com/docs/developers/apis/image-delivery-api/#resize-images</a>2.&nbsp;Update the width of the image and see the image size and dimensions being changed <img src="https://learnupon.s3.eu-west-1.amazonaws.com/576471/original/5395739f-6abc-477d-8df5-85c98301bd33-Screen_Shot_2023-05-02_at_2.17.52_PM.png" width="100"/><h2> Exercise: Auto-optimizing images with webp</h2>1.&nbsp;Navigate to the Automate Optimization section of the documentation,&nbsp;<a href="https://www.contentstack.com/docs/developers/apis/image-delivery-api/#enable-auto-optimization">https://www.contentstack.com/docs/developers/apis/image-delivery-api/#enable-auto-optimization</a>2. Leave the default as webp in the query parameters<img src="https://learnupon.s3.eu-west-1.amazonaws.com/576472/original/3a20e031-c973-4b47-864c-c990151c343b-Screen_Shot_2023-05-02_at_2.20.38_PM.png" width="100"/><h2>Using the Images API in your NextJS Applications</h2>Pass the width,&nbsp;height, or auto attributes to the src property in the img tag<img src="https://learnupon.s3.eu-west-1.amazonaws.com/576473/original/fee1998b-24e1-41c8-bcc8-ee70428c203e-Screen_Shot_2023-05-09_at_12.47.19_AM.png" width="100"/><h2>Exercise: Use the Images API to resize the home world image</h2>1.&nbsp; Update the NextJS code to apply a width param of 150px to the home world image.&nbsp; This resizes the image on the server-side and improves the performance of the page load. <img src="https://learnupon.s3.eu-west-1.amazonaws.com/576474/original/c62cc787-8b7d-4a61-a92f-b261a984dfbf-Screen_Shot_2023-05-09_at_12.52.49_AM.png" width="100"/>

Using the Images API

<h1>Exercise: Creating the Character Content Type</h1>In this module we will cover the following topics:<ul><li>How to build a Content Type</li><li>Review Field Types</li></ul>Marketing has provided us with requirements to promote our Composable Heroes by creating&nbsp;a section of the site where each hero will have their own detail page and be listed on a gallery page. In the next few exercises we will define the content type for a Composable Hero and&nbsp;build a hero detail page. &nbsp;There’s no time to waste, let’s get started!<h2>Analyze the Page Design</h2>When defining a new Content Type it's important to have the page design available (in photo / HTML format) so we can model the Content Type and define fields for the content elements.&nbsp;&nbsp;Analyze the following pages and think of the properties that a superhero character would need.&nbsp; When analyzing pages we often look for as many representations of the same content as possible, and then we combine all these fields into one Content Type.&nbsp; In this exercise, let's take a look at these two pages and see what fields they contain.&nbsp; We will focus on the main page content and ignore the headers and footer.&nbsp; If you would like to learn more, the Content Modeling course covers the content type fields in more detail.<img src="https://learnupon.s3.eu-west-1.amazonaws.com/576419/original/89e9ec57-5120-4ee8-a1d9-360e9b16af2f-Screen_Shot_2023-05-07_at_9.42.30_PM.jpg" width="100"/><img src="https://learnupon.s3.eu-west-1.amazonaws.com/576420/original/76c24c81-3df4-4d82-9ab6-2f7d6e8135b3-Screen_Shot_2023-05-07_at_9.28.44_PM.png" width="100"/><h2>Defining&nbsp;the Character Content Type for the Hero</h2>In the previous section we analyzed the hero pages and thinking of what fields to use for defining the pages.&nbsp; In this section, we will create the Content Type for the Character.&nbsp; If you wish to copy / paste the code samples later, we would advise you to define the content type with the fields in this exercise.&nbsp; However, if you wish to use your own field definitions, that's fine, but you will also need to adjust the code samples accordingly.Creating the Content TypeUsing the Content Type editor in Contentstack, create a new Content Type with fields for our Character content. &nbsp;While defining the fields, we will need to consider what content we want to show on the detail page. &nbsp;<div style="position: relative;overflow: hidden;padding-bottom: 56.25%;"><iframe src="https://cdn.jwplayer.com/players/Kv6fnat6-b769H14u.html" width="100%" height="100%" frameborder="0" scrolling="auto" title="Dev-creating The Character Content Type" style="position: absolute;" allowfullscreen=""></iframe></div> After the exercise, your Content Type should look like this:<img src="https://learnupon.s3.eu-west-1.amazonaws.com/576421/original/e6b48a68-8105-4d04-8e47-6a660bb9286a-Screen_Shot_2023-05-09_at_12.58.54_AM.png" style="max-width: 418px;width: 418;" width="418"/>Steps for the exercise: 1.&nbsp; Create a new Content Type, named ‘Character’ for the composable heroes 2.&nbsp; Add the following fields:Hero Name - Use the Title field Every Content Type in Contentstack has a Title field.&nbsp; We can give it a different display name such as 'Name' or 'Character Name', but we cannot remove it.URL For the Path, use '/composable-heroes/'&nbsp; and then select the option to append the Title to the URL.&nbsp; This is the most common way to define the URL structure.&nbsp; For Content Types where we know the kind of content each page has (character) and that they will have detail pages, we decide to use '/composable-heroes/' as the URL path and then add the title to the end. <img src="https://learnupon.s3.eu-west-1.amazonaws.com/576423/original/a4055110-3b05-43fb-a0f3-6355751098d4-Screen_Shot_2023-05-04_at_9.26.43_AM.png" width="429" height="auto" max-width="429" style="max-width: 429px;width: 429;height: auto;"/>Image (File) Contentstack has an <a href="https://www.contentstack.com/docs/developers/apis/image-delivery-api/">Images API</a> and supports uploading any media file, including images, up to 700 MB.&nbsp; For images, there are additional properties such as min/max on width or height, so the CMS ensures the images used in a field meet the minimum size requirements. <img src="https://learnupon.s3.eu-west-1.amazonaws.com/576424/original/2f33417f-aa75-4be4-9c57-c53a4ed06ac5-Screen_Shot_2023-04-26_at_1.08.11_PM.png" width="428" height="auto" max-width="428" style="max-width: 428px;width: 428;height: auto;"/>Description (JSON RTE)The JSON RTE field stores the content in JSON and the frontend webapp uses a <a href="https://github.com/contentstack/json-rte-serializer/">JSON RTE Serializer</a> after publishing to transform the JSON to HTML.&nbsp; There is also an <a href="https://www.contentstack.com/docs/developers/automation-hub-connectors/rte-formatter/">Automation Hub connector that can transform the RTE JSON to HTML</a>.&nbsp;&nbsp;The JSON RTE supports custom plugins and you can use the <a href="https://www.contentstack.com/docs/developers/developer-hub/get-started-with-building-apps-using-contentstack-app-sdk/">App SDK</a> and extend the Rich Text Area with your own customizations.&nbsp; Examples in the Marketplace include a word count extension and a Cloudinary extension.<img src="https://learnupon.s3.eu-west-1.amazonaws.com/576425/original/ffbba911-f239-40f7-b0dc-eb37c2c6377e-Screen_Shot_2023-04-26_at_1.08.56_PM.png" width="409" height="auto" max-width="409" style="max-width: 409px;width: 409;height: auto;"/>Powers (select field, add the powers)<img src="https://learnupon.s3.eu-west-1.amazonaws.com/576426/original/8a997970-e473-4b49-8238-127f6df95337-Screen_Shot_2023-04-26_at_1.14.30_PM.png" width="413" height="auto" max-width="413" style="max-width: 413px;width: 413;height: auto;"/>Contact Info (Group field, email, phone)Group fields help us organize content fields and in the UI the editor can collapse / open the group.&nbsp; They're also helpful when using the <a href="https://www.contentstack.com/docs/developers/create-content-types/about-field-visibility-rules/">Visibility Rules</a> in Content Types Home world (Reference field)The Home world has an image and some additional properties, so we use a Reference Field and define a Content Type for the Home World instead of using a select field or defining the fields here.<blockquote>Reference fields should be used when the content you want to include either already exists as a standalone entry (or part of one), or will be used by multiple content entries (either of the same type or not)</blockquote> SEOAdd a Global Field and choose the SEO Global Field <img src="https://learnupon.s3.eu-west-1.amazonaws.com/576427/original/e8906710-de5a-4608-ae60-65cb78377132-Screen_Shot_2023-04-26_at_1.18.05_PM.png" width="423" height="auto" max-width="423" style="max-width: 423px;width: 423;height: auto;"/> All Done!Congrats - you are done with the Content Type definition.&nbsp;&nbsp; 3.&nbsp; Now, let's try out the new Character Content Type.&nbsp; Create a new Entry with the Character Content Type and fill in the content and publish to Development<h2>Content Type Best Practices</h2>URL field: &nbsp;Best practices/patterns. &nbsp;Use the /path/:title for most content types, where relevant. &nbsp;This maps to the Route in the web application and is also important for SEO. Choose this wisely. Image field: &nbsp;Consider using the height/width limitations Text fields: &nbsp;Consider any validations Modular Blocks: Think of this as a ‘design system’ of components the user can choose from. &nbsp; They have the flexibility to add it if they want, or not. &nbsp;Blocks can also be added at a later time to extend the content type. This can be done in confidence that things will not break if adjustments are made.If you're using a modern framework such as NextJS or Nuxt, then we can think of having a NextJS Component responsible for rendering the content of one Modular Block.&nbsp; In this way, the content and design are atomic and can be re-used across multiple pages. Reference fields:&nbsp; When re-using content with many entries, we can use a Reference Field and connect the Entries.&nbsp; We will need to add an additional query parameter to the Content Delivery Queries so that the referenced Entry fields will also be returned.&nbsp; One example of using a reference field is on a homepage or landing page where we want to also show a listing of articles, products in a promo, etc.&nbsp;&nbsp; However, be mindful when implementing Reference fields as they can be easily overused. &nbsp;When modeling content, it’s best to keep the relationship &nbsp;as flat as possible and only use reference fields when referring to another type of content that is mostly independent of the model it is being referenced in. &nbsp;If content fields are only used by the current entry, then it’s better to include them in the content type rather than using a reference field. &nbsp;Reference field over-use is the most common content modeling pitfalls &nbsp;and increases the complexity of the system for end users.&nbsp;<h1>Create the NextJS Component for the superhero detail page</h1>Next step is to render the Character Entries on a superhero detail page.&nbsp; This process involves the following steps:<ol><li>Create a new NextJS Component and import the Contentstack libraries</li><li>Use the HTML Provided and add the code to render the Contentstack Character Content Type fields</li><li>Run locally and preview the page</li></ol>
 Now that we have defined our superheroes using the Character Content Type and added some sample content, it's time to create a detail page to display them on our website. The HTML file for the superhero detail page is provided below. Using Contentstack's Content Delivery API and Next.js, we can create the code to render this page on our website.<h2>Programming the Character Detail Page</h2>1. Create a new NextJS Component for the detail page in a folder 'composable-heroes' and using the name [post].tsx2.&nbsp; Analyze the code for the Detail page and notice how we render text fields, reference fields and group fields.&nbsp; <a href="https://github.com/contentstack/contentstack-academy-playground/blob/main/pages/composable-heroes/%5Bpost%5D.tsx">The code is available on Github here.</a>3.&nbsp; Examine&nbsp;the Helper/index.js file and <a href="https://github.com/contentstack/contentstack-academy-playground/blob/89452b765dac23970f24ece7412beefc62bb18ec/helper/index.js#L106">review the code for getting a Single Entry (Character Content Type)</a>.&nbsp; This function will use the existing method ‘GetEntryByUrl in the /contentstack-sdk/index.js file to query for the Entry content.&nbsp;<img src="https://learnupon.s3.eu-west-1.amazonaws.com/576428/original/ba2d9c71-9a7d-46a3-a41a-2c81a2578d35-Screen_Shot_2023-05-09_at_1.04.14_AM.png" width="100"/><a href="https://www.contentstack.com/docs/developers/sdks/content-delivery-sdk/javascript-browser/">Content Delivery JS SDK API Ref</a>
 <a href="https://gist.github.com/robertcurlette-cs/066c818c09c752426056eee7e9fa541c">Examples using the Content Delivery JS SDK in a NextJS Service</a>&nbsp;
 4.&nbsp; Call the Character Query function from the NextJS <a href="https://github.com/contentstack/contentstack-academy-playground/blob/89452b765dac23970f24ece7412beefc62bb18ec/pages/composable-heroes/%5Bpost%5D.tsx#L62">composable-heroes/[post].tsx file</a><img src="https://learnupon.s3.eu-west-1.amazonaws.com/576429/original/536c1ec8-26a2-4463-9b2c-ac1d4cb0c406-Screen_Shot_2023-05-09_at_1.05.22_AM.png" width="100"/> <h2><a href="https://github.com/contentstack/contentstack-academy-playground/blob/main/pages/composable-heroes/%5Bpost%5D.tsx">Code Solution for Composable Hero Detail Page on Github</a></h2> <h2>Field rendering syntax:</h2>Text fields - Rendering the title field{postData?.title}Group fields{postData?.contact_info?.email ? Email : {postData?.contact_info?.email}Images<img src="https://learnupon.s3.eu-west-1.amazonaws.com/576430/original/27ff385a-3aec-4a86-b6d6-846e1e93a850-Screen_Shot_2023-04-26_at_3.21.16_PM.png" width="100"/>
 Reference Field<img src="https://learnupon.s3.eu-west-1.amazonaws.com/576431/original/dd877173-7f63-433b-8f66-c0518119dea5-Screen_Shot_2023-05-08_at_12.14.37_AM.png" width="100"/> 6.&nbsp; Confirm your code with the Composable Detail Page solutionFinal Result - Composable Hero&nbsp;Detail Page<img src="https://learnupon.s3.eu-west-1.amazonaws.com/576432/original/1f0d87fe-ffd0-41b7-bda4-c4ba9d54a610-Screen_Shot_2023-05-07_at_9.28.44_PM.png" width="100"/>

Creating the Hero Detail Page

<h2>The Composable Hero&nbsp;Landing Page</h2>Welcome to this tutorial on creating a superhero gallery page using reference fields in NextJS! In this module, we'll walk you through the steps of creating a new content type called "Superhero Gallery Page" and adding heroes to it manually.&nbsp;We'll start by showing you how to utilize reference fields to display hero content on the landing page with their images and names. This technique is commonly used in product promotions and article index pages, so it's a valuable skill to learn.&nbsp;Next, we'll guide you through the process of creating a new NextJS component and query to retrieve the Landing Page Entry and Reference field Hero Entries. Our NextJS component will loop through all the heroes in the reference field and display their titles, images, and links to their respective detail pages.Finally, we'll demonstrate how to create a new Landing Page Entry and publish it to the Development environment to see the results of our work.By the end of this tutorial, you'll have gained valuable knowledge on how to utilize reference fields in NextJS to create reusable content and enhance the user experience on your website. Let's get started!<img src="https://learnupon.s3.eu-west-1.amazonaws.com/576433/original/7351ff1b-3d8b-41bd-8166-5e28ee77c3ac-Screen_Shot_2023-05-09_at_2.32.13_PM.png" width="556" height="auto" max-width="556" style="max-width: 556px;width: 556;height: auto;"/><h1> </h1><h2>Hero Gallery&nbsp;Page Content Type</h2><img src="https://learnupon.s3.eu-west-1.amazonaws.com/576434/original/0a22ff01-dad0-4e2e-8441-1d78383354a5-Screen_Shot_2023-05-09_at_2.36.28_PM.png" width="462" height="auto" max-width="462" style="max-width: 462px;width: 462;height: auto;"/><h2></h2><h4>Open the Superhero Gallery Page and examine the properties of each field</h4><img src="https://learnupon.s3.eu-west-1.amazonaws.com/576435/original/cdaab9d8-2f03-4f07-85e3-840ab35bc575-Screen_Shot_2023-05-09_at_1.09.30_AM.png" width="469" height="auto" max-width="469" style="max-width: 469px;width: 469;height: auto;"/>Review the following fields below:<ul><li>Title - Default Title field</li><li>URL - /gallery/:title</li><li>Heading - Text field</li><li>Description - Multi-line text</li><li>Characters - Reference field to the Character Content Type</li></ul><h2>Part 2: Writing the code to display the list of heroes</h2>Let's list all the heroes in the reference field on the Gallery&nbsp;page.&nbsp; Users can manually create a list of heroes and our code will loop over all the heroes in the reference field and render the name, image, and link.&nbsp; <h3>Rendering a list of Characters from a Reference Field</h3> 1.&nbsp;&nbsp;Create a NextJS Component for the Gallery page and loop through all the heroes in the reference field, rendering&nbsp;the title, image and a link to the detail page.&nbsp; This involves 2 steps, first writing the query function and then rendering the results. 2.&nbsp; Querying Contentstack for the Characters in the Reference Field <a href="https://github.com/contentstack/contentstack-academy-playground/blob/main/helper/index.js">In the /helpers/index.js file</a>, review the function to get a list of heroes from the reference field 3.&nbsp; <a href="https://github.com/contentstack/contentstack-academy-playground/blob/main/pages/composable-heroes/index.tsx">Review the code for the /composable-heroes/index.tsx file</a>.&nbsp;&nbsp; 4.&nbsp; Review the Composable Heroes Gallery Entry <img src="https://learnupon.s3.eu-west-1.amazonaws.com/576436/original/ff9608d8-86a2-47b1-bb4e-18eb9fd72215-Screen_Shot_2023-05-09_at_1.13.41_AM.png" width="100"/> 5.&nbsp; From the NextJS application, open the Composable Heroes Gallery Page<img src="https://learnupon.s3.eu-west-1.amazonaws.com/576437/original/85ca2631-13ac-4c17-9940-82a4086a4088-Screen_Shot_2023-05-09_at_1.14.40_AM.png" width="100"/> 2. Introduction to using the Query functions of the Content Delivery APIContentstack provides certain queries that you can use to fetch filtered results. You can use queries for Entries and Assets API requests.&nbsp; Please review the <a href="https://www.contentstack.com/docs/developers/apis/content-delivery-api/#queries">Content Delivery Query API documentation</a> and examine the RegEx, Limit and Only functions.For the first part of the exercise, we can use a simple query to find all the entries with the Content Type of Character.&nbsp;&nbsp;<h3>Postman</h3>1.&nbsp; Open Postman and select the Entries/Get Entries call Update the parameters / variables so that:<ul><li>content_type_uid = character</li><li>environment = development </li></ul><img src="https://learnupon.s3.eu-west-1.amazonaws.com/576438/original/cb5eafd4-786d-4d22-b071-b2ba5d4df15e-Screen_Shot_2023-05-04_at_10.11.17_AM.png" width="100"/>You should now have a list of the characters published to the development environment.&nbsp; In the next section, we will use the JavaScript SDK to get the same list and pass it to the NextJS App to render. 3. Query using Javascript SDKIn our web application we will mostly use the <a href="https://www.contentstack.com/docs/developers/sdks/content-delivery-sdk/javascript-browser/reference/">Javascript Content Delivery SDK</a>.&nbsp; Please have a look at the <a href="https://www.contentstack.com/docs/developers/sdks/content-delivery-sdk/javascript-browser/reference/#query">documentation for the query methods</a>.Other SDKs can be found on the <a href="https://www.contentstack.com/docs/developers/sdks/">SDKs documentation page</a><pre>import Contentstack from 'contentstack'; const Stack = Contentstack.Stack({"api_key": "api_key", "delivery_token": "delivery_token", "environment": "environment"}); const result = await Stack.ContentType('character').Query().toJSON().find();</pre><a href="https://www.contentstack.com/docs/developers/sdks/content-delivery-sdk/javascript-browser/reference/#stack-query">More information about this is found in the Javascript SDK Docs</a><h2>Composable Hero Landing Page</h2>The Composable Hero Landing Page uses <a href="https://www.contentstack.com/docs/developers/create-content-types/modular-blocks/">Modular Blocks</a> to provide a flexible structure for authors to create content and add as many content blocks to the page as they wish and also to re-order the blocks.&nbsp;&nbsp;<img src="https://learnupon.s3.eu-west-1.amazonaws.com/576439/original/e0b510f4-af55-47bd-ab1b-828aeac8f24c-Screen_Shot_2023-05-09_at_2.43.15_PM.png" width="100"/> <h2>Open the Superhero Landing Page Entry and review the content</h2><img src="https://learnupon.s3.eu-west-1.amazonaws.com/576440/original/ba505a62-160b-4fcd-9c14-8dd286465340-Screen_Shot_2023-05-09_at_2.39.02_PM.png" width="100"/><h2> </h2><h2>Open the Content Type Definition and examine how the Modular Blocks field is used.&nbsp;</h2>Notice the fields are greyed out - that is because the Modular Block fields are defined using Global Fields.&nbsp; This is a best practice.<img src="https://learnupon.s3.eu-west-1.amazonaws.com/576441/original/6abb16ec-3b2f-41bc-bae3-08bd7ec5e042-Screen_Shot_2023-05-09_at_2.45.56_PM.png" width="100"/><h2>Global Field Definitions</h2><img src="https://learnupon.s3.eu-west-1.amazonaws.com/576442/original/ae57a06e-2739-4b32-bada-3a97492cc80f-Screen_Shot_2023-05-09_at_2.47.42_PM.png" width="100"/><h2> </h2><h2>Examine the Code used for the Hero Landing Page</h2>The <a href="https://github.com/contentstack/contentstack-academy-playground/blob/main/pages/gallery.tsx">code for the Gallery Entry (Page)</a>&nbsp;loops through all the Modular Blocks on the page and renders each one with its' own NextJS Component. <img src="https://learnupon.s3.eu-west-1.amazonaws.com/576443/original/7f386f93-cfcc-4b17-91cf-7a37bc2191b4-Screen_Shot_2023-05-09_at_3.10.22_PM.png" width="684" height="auto" max-width="684" style="max-width: 684px;width: 684;height: auto;"/><h2>Each block is rendered with its own NextJS Component</h2><ul><li><div><a href="https://github.com/contentstack/contentstack-academy-playground/blob/main/components/gallery.tsx">Gallery Block</a><a href="https://github.com/contentstack/contentstack-academy-playground/blob/main/components/gallery.tsx"> </a><div><img src="https://learnupon.s3.eu-west-1.amazonaws.com/576444/original/a02cc6fd-09ab-4fb8-8a99-d7952aa8fa0b-Screen_Shot_2023-05-09_at_3.07.40_PM.png" width="591" anchorlink="https://github.com/contentstack/contentstack-academy-playground/blob/main/components/gallery.tsx" height="auto" max-width="591" style="max-width: 591px;width: 591;height: auto;"/></div></div> </li><li><div><a href="https://github.com/contentstack/contentstack-academy-playground/blob/main/components/hero-banner.tsx">Hero Banner Block</a><a href="https://github.com/contentstack/contentstack-academy-playground/blob/main/components/hero-banner.tsx"> </a><div><img src="https://learnupon.s3.eu-west-1.amazonaws.com/576445/original/b5794bc2-878a-43d6-9cc9-b93f6898929c-Screen_Shot_2023-05-09_at_3.05.27_PM.png" width="552" anchorlink="https://github.com/contentstack/contentstack-academy-playground/blob/main/components/hero-banner.tsx" height="auto" max-width="552" style="max-width: 552px;width: 552;height: auto;"/></div></div></li></ul>By adopting this approach, we can isolate the HTML/Code for each block within a single NextJS Component. This simplifies maintenance and enables easy extension of the page in the future by adding a Modular Block and NextJS Component for additional content block types.&nbsp;With this method, you can modify the individual content blocks without having to make changes to the entire page structure. This approach makes the codebase more organized and easier to manage, especially when dealing with complex web applications.&nbsp;By leveraging this technique, you can increase the scalability and modularity of your website, allowing you to add new features and functionalities with ease.

Creating the Hero Gallery Page

<h3>Using Modular Blocks - Advantages</h3>There are several advantages to using Contentstack's modular blocks when designing content types. Here are some of the key advantages:1. Flexibility for marketers: Modular blocks allow marketers to easily create and customize content without requiring technical expertise. With modular blocks, marketers can easily use pre-designed content blocks to create engaging content without having to worry about formatting or layout.2. Reusability: With Global Fields, Modular blocks can be reused across different content types and pages, which can help to save time and effort when creating new content.3. Consistency: Modular blocks ensure consistency in content formatting and layout, which can help to improve the overall user experience.4. Granular control: Modular blocks provide developers with granular control over content structure and formatting, which can help to ensure that content is properly organized and optimized for SEO.5. Easy maintenance: With modular blocks, it is easy to update and maintain content without having to modify the entire content type or page.7. Future-proofing: Modular blocks provide a future-proof solution for content design, as they can be easily updated and modified to meet changing business needs.<h2>Example:&nbsp; Using Modular Blocks in the&nbsp; Starter App</h2>In the Starter App, the Page Content Type uses Modular Blocks to define the various sections of the page.&nbsp; In this example below, notice how each block or module on the page is a Modular Block.&nbsp; In this example we have 3 Modular Blocks.<img src="https://learnupon.s3.eu-west-1.amazonaws.com/576483/original/1e5e7a8d-d933-463c-a2ad-7c06c2a2da8b-Screen_Shot_2023-05-03_at_11.14.20_AM.png" width="100"/> These Blocks are used in the Page Content Type.<img src="https://learnupon.s3.eu-west-1.amazonaws.com/576484/original/7d7e42c3-cee6-42b1-8ac8-b29a8f32668d-Screen_Shot_2023-05-03_at_11.12.53_AM.png" width="100"/> <h2>Using Global Fields for Defining Re-Usable Content Structures</h2>Global Fields in Contentstack promote the re-use of content structures across content types.&nbsp; They allow us to define a schema of fields and then reference that definition from another content type or modular block.In the StarterApp website, the SEO fields are defined as Global Fields. This makes it easy to manage the SEO fields from one location and re-use the definition across all content types.<img src="https://learnupon.s3.eu-west-1.amazonaws.com/576485/original/0739517a-093e-4ae1-99a9-7e4ca5ee8170-Screen_Shot_2023-05-03_at_11.18.29_AM.png" width="100"/><img src="https://learnupon.s3.eu-west-1.amazonaws.com/576486/original/82a84dd9-2701-48b5-be98-a67313de2711-Screen_Shot_2023-05-03_at_11.19.28_AM.png" width="100"/> <h2>Using Global Fields for Modular Blocks</h2>Global fields can&nbsp; also be used to define field sets for Modular Blocks. This is a great way to re-use structure.&nbsp; Note, it is currently not possible to nest a Global Field inside another Global Field, so take that into consideration when designing your content types.<h2>Resources</h2><ul><li><a href="https://www.contentstack.com/docs/developers/create-content-types/modular-blocks/">Modular Blocks</a></li><li><a href="https://www.contentstack.com/docs/developers/global-field/">Global Fields</a></li><li><a href="https://www.contentstack.com/docs/developers/global-field/limitations-of-global-field/">Limitations of Global Fields</a></li><li><a href="https://www.contentstack.com/docs/developers/content-modeling/content-modeling-best-practices/">Content Modeling Best Practices</a></li></ul>

Design Patterns with Content Types

With Contentstack's launch product, developers can focus on building and updating their applications while leaving the hosting infrastructure to Contentstack.To assist users with the various functionalities of this product, Contentstack offers a <a href="https://www.contentstack.com/docs/developers/launch/">comprehensive help center</a> on its website. The help center includes detailed guides and tutorials on <a href="https://www.contentstack.com/docs/developers/launch/import-project-using-github/">creating projects</a>, <a href="https://www.contentstack.com/docs/developers/launch/deploy-hooks/">setting up deploy hooks</a>, and <a href="https://www.contentstack.com/docs/developers/launch/redeploy-automatically-when-content-is-published-on-CMS/">redeploying applications</a> when content is published. Additionally, the website provides a robust community forum where users can interact with other users, share their experiences, and get support from the Contentstack team.<ul><li>Host&nbsp;your website or web app directly from Contentstack, leveraging our high-speed CDN and proven infrastructure.</li><li>Link&nbsp;your Contentstack Stacks and front-end environments without copying and pasting API keys.</li><li>Leverage&nbsp;the only front-end site hosting solution that’s built explicitly for the Contentstack CMS.</li></ul><h2>Framework agnostic</h2>Build projects in virtually any common Javascript front-end framework, easily connect to and deploy code directly from a git repository.<ul><li>Automatic&nbsp;configuration for Nextjs and Gatsby, with more frameworks on the way</li><li>Use&nbsp;virtually any composable Javascript front-end framework with custom build commands.</li><li>Upload&nbsp;static site files via Zip for instant deployment for projects that don’t use git.</li><li>Support&nbsp;for Edge functions and more&nbsp;coming soon!</li></ul><h1>Exercise: Deploy the site with Contentstack Launch</h1>1.&nbsp; Open Launch
 <img src="https://learnupon.s3.eu-west-1.amazonaws.com/576475/original/a9960371-c5f0-4ac2-b19b-2501027d168e-Screen_Shot_2023-05-02_at_5.23.55_PM.png" width="100"/>
 2.&nbsp; New Project
 3.&nbsp; Upload File<img src="https://learnupon.s3.eu-west-1.amazonaws.com/576476/original/b77286c5-3952-468d-b4a7-36a0e493f026-Screen_Shot_2023-05-02_at_5.30.18_PM.png" width="100"/>
 4. Upload the StarterApp project.&nbsp; In this example, we will use the NextJS Starter App.&nbsp; Download the code from the Github repository here:&nbsp;<a href="https://github.com/contentstack/contentstack-nextjs-starter-app">https://github.com/contentstack/contentstack-nextjs-starter-app</a>
 5.&nbsp; Select your Stack with the Starter App and then Import Environment Variables<img src="https://learnupon.s3.eu-west-1.amazonaws.com/576477/original/facb6650-d650-49de-bba1-379cd6daa9d0-Screen_Shot_2023-05-02_at_5.39.21_PM.png" width="100"/>6.&nbsp; Site is being deployed.&nbsp; This takes up to 5 minutes.&nbsp; The URL will be a Contentstack URL with the free trial, however, with a paid plan you will be able to use custom domains.<img src="https://learnupon.s3.eu-west-1.amazonaws.com/576478/original/41220368-8584-48c8-9294-e2c6b160b1e1-Screen_Shot_2023-05-02_at_5.34.30_PM.png" width="100"/>
 7.&nbsp; Site is deployed <h3>Learn More About Launch</h3><ul><li><a href="https://www.contentstack.com/docs/developers/launch/">Developer Documentation</a></li><li><a href="https://community.contentstack.com/search?q=Launch&search_type=tag">Community Forum</a></li><li><a href="https://www.contentstack.com/docs/developers/launch/quick-start-nextjs/">Guide for Deploying the StarterApp with Launch</a></li></ul>

Deploying the Starter App with Contentstack Launch

<h2>Introduction to the Content Management API</h2>Our Content Management API (CMA) is a powerful tool that provides a read/write API with a REST interface, as well as SDKs for JavaScript, .NET, and Java. To authenticate with the CMA, we use Tokens. In this exercise, we'll guide you through how to use the CMA with Postman, a popular tool that helps developers use APIs.Let's get started with the exercise. We'll be using Postman, so first, make sure to download the latest Contentstack Postman collection from here: <a href="https://www.contentstack.com/docs/developers/apis/content-management-api/#install-postman">https://www.contentstack.com/docs/developers/apis/content-management-api/#install-postman</a>Also, download and use the Postman Environment Files from Github here: <a href="https://github.com/contentstack/contentstack-postman-collections#environment-files">https://github.com/contentstack/contentstack-postman-collections#environment-files</a><img src="https://learnupon.s3.eu-west-1.amazonaws.com/576448/original/0b816fb7-b254-460a-9ed3-44dcdd58c593-Screen_Shot_2023-05-08_at_12.11.44_PM.png" width="100"/>
 The next step is to create a Management Token to use in our Postman query. To do this, go to Settings in the Contentstack UI, then Tokens, Content Management, and create a Management Token. You can follow this guide for more detailed instructions: <a href="https://www.contentstack.com/docs/developers/create-tokens/generate-a-management-token/">https://www.contentstack.com/docs/developers/create-tokens/generate-a-management-token/</a><img src="https://learnupon.s3.eu-west-1.amazonaws.com/576449/original/55d959c4-0c30-4fd8-aa1d-430234bd3327-Screen_Shot_2023-05-08_at_2.16.32_PM.png" width="100"/>
 Now, open Postman and add the Content Management API Postman Collection. Select Content Management API - Contentstack, Entries, Get a single entry, and you're ready to go!In Postman, select Content Management API -&nbsp;Contentstack, Entries, Get a single entry
 Update the API Key and Access TokenThere are two ways to set the values, using Postman variables like above or hard-coding the values in the Value column. &nbsp;I prefer to use the Environment variables. <a href="https://github.com/contentstack/contentstack-postman-collections#environment-files">https://github.com/contentstack/contentstack-postman-collections#environment-files</a>1.&nbsp; Set the Environment variable values for your Stack in Postman by selecting the icon in the top-right of Postman to open the Environment variable window.Specify the following header values:
 - api_key - This is located in the Settings, Tokens, Management Token page. &nbsp;You can also see it in the URL of the browser, after the /stack/ part of the URL, http://app.contentstack.com/#!/stack/{api_key}- authorization - Management token created in step 12.&nbsp; Use the ‘Get a single entry’’ method and add the base_url, content_type_uid (character) and entry uid to the query. &nbsp;This will retrieve the JSON for the Entry using the backend CMA. &nbsp;*Note, we do not use this API for our frontend website applications as it is not intended for high load / performance. &nbsp;Instead, the frontend web applications use the Content Delivery API which is tuned for high performance.3.&nbsp; Run the query and see the JSON result.
 Notice that we have Create / Read / Update / Delete operations for most types.
 Using the JSON returned from the Get Entry method, we will create new JSON to use for the Create Entry method in the next exercise.
 &nbsp;
 Learn More:
 Key Features of Management Tokens: <a href="https://www.contentstack.com/docs/developers/create-tokens/key-features/">https://www.contentstack.com/docs/developers/create-tokens/key-features/</a><h2>Creating content with the API:&nbsp; Using the Content Management API</h2><h3>Exercise: &nbsp;Create an entry with the Postman API</h3>In this exercise, we'll guide you through creating a new Entry in Contentstack programmatically using our Content Management API. This method is incredibly useful for quickly migrating content from external systems and avoiding manual entry.The trickiest part of this process is creating well-formed JSON that contains all the properties and content for the Entry. But don't worry - we've got you covered. In the previous exercise, we used our CMA to retrieve the Entry JSON, and now we'll use a subset of that JSON to create our new Entry.If you weren't able to retrieve the JSON Entry export in the previous exercise, we've included a sample below. Just make sure to update the UID of the Content Type for it to work.To get started, let's create the Entry JSON required to make a new Entry. Below is an example JSON, but remember to replace the Content Type UID:<pre>{ "title": "New Entry Title", "url": "/new-entry-url", "description": "This is a new Entry created programmatically using the Content Management API.", "content_type_uid": "your-content-type-uid", "metadata": { "tags": ["tag1", "tag2"], "author": "John Doe" }, "body": "</pre><pre>This is the body of the new Entry.</pre><pre>" }</pre>Now, in Postman, open the ‘Create an entry’ method and in the body tab, paste the JSON of the new Entry. Please note that the Title property of the Entry needs to be unique.As we used Postman variables in the previous exercise, you won't need to add any additional settings here, since the api_key and management token are already specified.Finally, hit the Send button in Postman to create your new Entry. Head over to the Contentstack UI to confirm that it has been created successfully.<h2>Exporting Content from Contentstack</h2>Contentstack stores all text content in JSON format.&nbsp; This makes it very easy to import / export and update content using the Content Management API or the CLI.&nbsp; In this section we will discuss the three ways to export content from Contentstack:&nbsp; UI, CM API, and the CLI.<h2>Exporting with the UI</h2><img src="https://learnupon.s3.eu-west-1.amazonaws.com/576450/original/53d9742d-b104-4073-b504-fb9397bcd254-Screen_Shot_2023-05-09_at_12.44.54_PM.png" width="100"/><h2>
 </h2><h2><a href="https://www.contentstack.com/docs/developers/apis/postman-collections/">Exporting with Postman</a></h2><img src="https://learnupon.s3.eu-west-1.amazonaws.com/576451/original/e0fbe528-81a9-4655-8ee4-4a24dab61752-Screen_Shot_2023-05-09_at_12.49.30_PM.png" width="100"/><h2>
 </h2><h2><a href="https://www.contentstack.com/docs/developers/cli/export-content-using-the-cli/">Exporting with the CLI</a></h2><img src="https://learnupon.s3.eu-west-1.amazonaws.com/576452/original/4179c27a-8eab-42dd-b435-4b60e0208ac6-Screen_Shot_2023-05-09_at_12.54.00_PM.png" width="100"/> <h2>Exporting Content from Contentstack</h2>Contentstack stores all text content in JSON format.&nbsp; This makes it very easy to import / export and update content using the Content Management API or the CLI.&nbsp; In this section we will discuss the three ways to export content from Contentstack:&nbsp; UI, CM API, and the CLI.<h4>Exporting with the UI</h4><img src="https://learnupon.s3.eu-west-1.amazonaws.com/576450/original/53d9742d-b104-4073-b504-fb9397bcd254-Screen_Shot_2023-05-09_at_12.44.54_PM.png" width="100"/><h2>
 </h2><h4><a href="https://www.contentstack.com/docs/developers/apis/postman-collections/">Exporting with Postman</a></h4><img src="https://learnupon.s3.eu-west-1.amazonaws.com/576451/original/e0fbe528-81a9-4655-8ee4-4a24dab61752-Screen_Shot_2023-05-09_at_12.49.30_PM.png" width="100"/><h2> </h2><h4><a href="https://www.contentstack.com/docs/developers/cli/export-content-using-the-cli/">Exporting with the CLI</a></h4><img src="https://learnupon.s3.eu-west-1.amazonaws.com/576452/original/4179c27a-8eab-42dd-b435-4b60e0208ac6-Screen_Shot_2023-05-09_at_12.54.00_PM.png" width="100"/>

Importing Content with the CLI and CMA

<h2>Roles</h2>Contentstack has a robust roles and permissions system with built-in roles such as 'Admin', 'Developer', and 'Content Manager' and the ability to create custom roles for authors and editors.&nbsp; In this module we will look briefly at the roles and permissions system in Contentstack.Built-in RolesAdmin:&nbsp;Admin has full access to all features and functions within Contentstack, including the ability to create, edit, and delete content, manage users and roles, and configure the system settings. Super Admins have the highest level of privileges and can perform any action within the platform.Content Manager: The Content Manager has the ability to create, edit, and delete content, as well as manage users and roles. However, they do not have access to the system settings or the ability to perform advanced tasks such as configuring webhooks or integrations.Developer: The Developer role is designed for users who need to access the Contentstack API and develop custom solutions using the platform. Developers have the ability to create and manage content types, as well as access the API documentation and sample code. However, they do not have the ability to manage users and roles. Custom RolesIn Contentstack, custom roles allow users to define and customize the level of access and permissions for specific users or groups of users. This provides greater flexibility and control over how content is managed and published within the system.To create a custom role, a Super Admin or a user with the "Manage Roles" permission can navigate to the Roles section of the Contentstack dashboard and click on the "Add Role" button. From here, they can give the custom role a name and select the specific permissions that they want to grant to users assigned to that role.The available permissions can be grouped into three categories:<ul><li>Content: permissions related to creating, editing, and publishing content and images</li><li>Publishing: permissions related to publishing content and environments</li><li>Languages: Permissions relating to localization</li></ul>Once the custom role is created, it can be assigned to specific users or groups of users within the system. Users assigned to the custom role will only have access to the permissions and features that are granted to that role, ensuring that they only have access to the specific tasks and content that they are responsible for. This helps to improve security and streamline workflows within the system.<h2>Exercise: Creating a custom role</h2>&nbsp;Here are the steps to create a custom role in Contentstack:1. Log in to your Contentstack account and navigate to the “Settings / Users &amp; Roles / Roles” section of the dashboard.2. Click on the “New Role” button to create a new custom role.3. In the “Role Details” section, enter a name for your custom role.4. Next, choose the permissions you want to grant to this role by selecting the options for each permission category (Content, Assets, Languages and Environments).5. Under each permission category, you can select or deselect specific permissions that you want to include or exclude for this role.7. Once you have selected the permissions you want to grant to the custom role, click the “Save” button to save the role.8. To assign users to the custom role, navigate to the “Users” section of the dashboard and select the user(s) you want to assign the role to.9. In the “Update User” dialog box, select the “Roles” tab, and then select the custom role you created from the list of available roles.10. Click the “Save” button to save the changes.That's it! You have now created a custom role in Contentstack and assigned it to specific users within your organization.<h3>Resources</h3><ul><li><a href="https://www.contentstack.com/docs/developers/invite-users-and-assign-roles/examples-to-create-custom-roles/">Examples to create custom roles</a></li></ul><div style="position: relative;overflow: hidden;padding-bottom: 56.25%;"><iframe src="https://cdn.jwplayer.com/players/owFEMYhE-b769H14u.html" width="100%" height="100%" frameborder="0" scrolling="auto" title="Dev-roles In Contentstack" style="position: absolute;" allowfullscreen=""></iframe></div>

Working with Roles and Permissions

Contentstack's workflow feature is a powerful tool that enables organizations to manage the content creation and publishing process in a streamlined and efficient way. With workflow, content creation and publishing becomes a collaborative process that involves multiple stakeholders, including writers, editors, and approvers.&nbsp;The workflow feature allows you to define a series of states that content can go through, from initial creation to final approval and publishing. Each state represents a stage in the content creation process, and can be assigned to different roles or users. For example, you can set up states such as "Draft", "In Review", "Approved", and "Published".As content moves through the workflow, it can be edited, reviewed, and approved by different users based on their assigned roles. Users can add comments and feedback, and content can be easily tracked and managed throughout the entire process. This ensures that content is thoroughly reviewed and approved before being published, minimizing the risk of errors or inaccuracies.Contentstack's workflow feature also includes notifications and alerts, which keep everyone involved in the process informed of content changes, updates, and approvals. This helps to keep the process moving smoothly and ensures that everyone is on the same page.<img src="https://learnupon.s3.eu-west-1.amazonaws.com/576482/original/d66f2fac-5ce5-4725-89f4-c6e7e7e87938-Screen_Shot_2023-05-03_at_11.06.04_AM.png" width="100"/><h2>Exercise: Creating a Workflow with a Publish Rule</h2>Here's a step-by-step guide on how to use Contentstack's workflow feature to create a publishing rule for production:Step 1: Log in to your Contentstack account and select the stack you want to work with.Step 2: Click on the "Settings" button in the top navigation bar.Step 3: Click on the "Workflows" tab.Step 4: Click on the "New Workflow" button.Step 5: Enter the following:
 - Name: &nbsp;"Blog Workflow". &nbsp;
 - Scope (branches): Main. &nbsp;
 - Specific Content Types: Blog EntryStep 6: Add the states that content will go through before being published. For example, you could add the states "Draft", "In Review", "Approved", and "Published".Step 7: Click on the "Enable Workflow" checkbox and the "Save" button to create the workflow.Step 8: Next, you'll need to create a publishing rule that specifies which content should be published to your production environment. Click on the "Publishing Rules" tab.Step 9: Click on the "New Publishing Rule" button.Step 10: Enter a name for your publishing rule, such as "Publish to Production".Step 11: Under "Content type", select the "Blog Entry" Content TypeStep 12: Under "Language", select "All Languages"Step 13: Under "Environment", select "Production"Step 14: Under "Rule Conditions", you can set up conditions that must be met before the content is published. For example, you could require that the content has the "Approved" state before it can be published.Step 15: Click on the "Save" button to save the publishing rule.Step 16: Now, whenever content is created or updated, it will go through the workflow you created in step 5. If the content meets the conditions you set up in the publishing rule, it will be published to your production environment automatically.Congratulations! You have successfully created a publishing rule for production using Contentstack's workflow feature. This will help you streamline your content creation and publishing process and ensure that only approved content is published to your production environment.<h2>Example: Using Workflow and Webhooks for Automating Translation</h2>In the context of a Contentstack workflow, a webhook trigger can be used to automate the movement of content through the different stages of the workflow or send to an external service such as a translation agency.&nbsp;To set up a webhook trigger to use a workflow stage in Contentstack, you would first need to create a workflow and define the stages that content should go through. Once the workflow is set up, you can create a webhook trigger that is triggered when content is created or updated.In the webhook trigger settings, you can specify the workflow stage that the content should be moved to when the webhook is triggered. For example, you could set up the webhook trigger to move the content from the "Draft" stage to the "In Review" stage when it is created or updated.Once the webhook trigger is set up, it will automatically move the content through the workflow based on the rules that you have defined. This can help to save time and improve efficiency, as content can be automatically routed to the appropriate stage without requiring manual intervention.
 Step 1: Set up your workflow in Contentstack
 First, you'll need to set up your workflow in Contentstack to define the stages that content should go through before it is published. For example, you might create stages for "Draft", "In Review", and "Approved".Step 2: Set up a webhook trigger
 Next, you'll need to set up a webhook trigger that is triggered when content is created or updated. In the webhook trigger settings, you can specify the URL of your 3rd-party translation service, along with any required authentication details.Step 3: Define a workflow stage for translation
 In your workflow, you can define a new stage specifically for translation. For example, you might create a stage called "Translation" that is between the "In Review" and "Approved" stages.Step 4: Set up a webhook action to send content to the translation service
 In the workflow stage for translation, you can set up a webhook action that sends the content to the 3rd-party translation service. You can use the webhook trigger that you set up in step 2 to automatically send the content to the translation service when it enters the "Translation" stage.Step 5: Receive and process the translated content
 Once the content has been sent to the translation service, the service will translate the content into the desired language(s). The translation service can then send the translated content back to Contentstack via another webhook trigger.Step 6: Move the translated content to the next stage in the workflow
 When the translated content is received by Contentstack, you can set up another webhook action that automatically moves the content to the next stage in the workflow. For example, you might move the content from the "Translation" stage to the "Approved" stage when it is received.Overall, using a Contentstack webhook trigger with workflow to send content to a 3rd-party translation service can help to streamline the translation process and ensure that content is translated efficiently and accurately.&nbsp;<h1>Resources</h1><ul><li><a href="https://www.contentstack.com/docs/developers/set-up-workflows-and-publish-rules/">Workflow Documentation</a></li><li><a href="https://www.contentstack.com/docs/developers/how-to-guides/#translation-services">Translation Integrations</a></li></ul>

Workflow

Contentstack's webhook system is a powerful tool that allows developers to automate the process of receiving real-time notifications of changes made to content within the CMS. A webhook is an HTTP callback that sends a notification to a specified URL whenever a specific event occurs. In the case of Contentstack, the event could be when content is created, updated, deleted, or published.Developers can create webhooks in Contentstack and specify which events should trigger them. When an event occurs, Contentstack sends an HTTP POST request to the specified URL, containing information about the event and the associated content.With this information, developers can automate processes such as updating search indexes, notifying team members of content changes, or triggering other third-party services. Additionally, Contentstack allows developers to set up conditional logic to filter webhooks based on specific criteria, such as content types, allowing for even more granular control over webhook behavior.<h2>Exercise: Using a webhook to call an endpoint on the webhook.site service</h2>Step 1: Go to <a href="https://webhook.site">webhook.site</a> in your web browser.Step 2: Click on the "Create a webhook" button on the top right corner of the webpage.Step 3: In the "Create a new webhook" modal, you'll see a unique webhook URL that you can use to send HTTP requests. Copy this URL to your clipboard.Step 4: Log in to your Contentstack account and go to the Settings section of your stack.Step 5: Click on the "Webhooks" tab.<img src="https://learnupon.s3.eu-west-1.amazonaws.com/576479/original/dbe7d899-ba53-49f0-9a17-e7d053afe841-Screen_Shot_2023-05-03_at_10.24.36_AM.png" width="100"/>
 Step 6: Click on the "Add New Webhook" button.Step 7: In the "Create Webhook" modal, enter a name for your webhook, such as "Webhook.site Test".
 Step 8: In the "URL" field, paste the webhook URL that you copied from webhook.site in step 3.<img src="https://learnupon.s3.eu-west-1.amazonaws.com/576480/original/514bd36e-5cf5-4138-88ab-8abfa45ce57c-Screen_Shot_2023-05-03_at_10.26.32_AM.png" width="100"/>Step 9: Under "Webhook Triggers", select "Publish" as the trigger event.<img src="https://learnupon.s3.eu-west-1.amazonaws.com/576481/original/8a3fd73e-021d-4b68-b822-830a0549e0e5-Screen_Shot_2023-05-03_at_10.26.49_AM.png" width="100"/>Step 10: Click on the "Save" button to save the webhook.Step 11: Now, whenever you publish content in Contentstack, a webhook notification will be sent to the URL you specified in step 8.Step 12: To test the webhook, publish a new piece of content in Contentstack.Step 13: Return to webhook.site and click on the "Inspect" button next to the webhook that you just created. You should see the webhook notification data from Contentstack, including the published content.Congratulations! You have successfully tested a Contentstack webhook using webhook.site. You can now use webhook.site to test your webhook implementations or receive webhook notifications from other services.<h2>Learn More</h2><ul><li><a href="https://www.contentstack.com/docs/developers/set-up-webhooks/">Webhooks Documentation Page</a></li><li><a href="https://community.contentstack.com/search?q=webhooks">Community Forum</a></li></ul>

Webhooks

<h2>Sending HTTP Messages with Automate</h2>
An&nbsp;<a href="https://www.contentstack.com/docs/developers/automation-hub-connectors/http-action/">HTTP Action</a>&nbsp;allows us to send an HTTP call when a trigger event occurs. This enables us to send JSON from an&nbsp;entry, asset, or release&nbsp;to any service that accepts an HTTP POST, GET, PUT, DELETE, or PATCH. In this module we will use an&nbsp;HTTP Action connector&nbsp;to send the&nbsp;entry&nbsp;JSON to an external webhook listener. This method can be used to integrate with third-party systems that do not&nbsp;have a pre-built connector but can receive a GET or POST request.
Topics covered:
<ul>
 <li>
 Sending JSON to an external web service
 </li>
 <li>
 Using the website&nbsp;<a href="http://webhook.site/">http://webhook.site</a>&nbsp;to receive to our HTTP message
 </li>
</ul>
Please watch the following video to see an example of sending an HTTP message with&nbsp;automate:

<div style="position: relative;overflow: hidden;padding-bottom: 56.25%;"><iframe src="https://cdn.jwplayer.com/players/jmJmjKiy-b769H14u.html" width="100%" height="100%" frameborder="0" scrolling="auto" title="Dev-course Automation Hub, Connect To 3rd Party Webservice" style="position: absolute;" allowfullscreen=""></iframe></div>

<h3>Exercise:&nbsp;Create a new Automation that sends an HTTP Post request to a 3rd party web service when an entry&nbsp;is published</h3>
1. Create a new Automation using a Contentstack Trigger 2. Add a new action&nbsp;and use the HTTP Connector&nbsp; 3. Go to http://webhook.site and create a new webhook listener 4. In the Configure Action step, specify the URL of the webhook from above

Automate- Using an HTTP Connector to Send Data to a 3rd Party System

The <a href="https://www.contentstack.com/docs/developers/marketplace-platform-guides/">Contentstack Marketplace</a> is a platform for apps and other resources that help you extend the capabilities of our core CMS and customize its functionalities. It is a one-stop resource to discover, browse, and install tools to enhance the Contentstack experience by connecting to various third-party services in a simple installation. The <a href="https://www.contentstack.com/docs/developers/marketplace-apps/">apps</a> and resources on Marketplace are created by Contentstack and our partners.&nbsp;<img src="https://learnupon.s3.eu-west-1.amazonaws.com/576487/original/6f4bd6cd-9710-4c45-9dd9-fc5e58005c97-LinkedIn_Screen_Grabs_for_LearnUpon_(1).jpg" width="100"/>Contentstack Marketplace is Contentstack’s very own app distribution platform similar to the App Store in Apple, or the Play Store in Android. You can use and install apps from our Marketplace to extend the existing capabilities of your Contentstack web application.Marketplace Apps allow you to extend the capability of our core CMS and customize its functionalities. With these ready-to-use apps, you can integrate your favorite third-party platforms easily and with minimal effort. These pre-built apps are intended to be quickly and easily installed. Apps like this are built to solve a particular problem, help integrate with a specific software, or provide functionality for a user of Contentstack.

What is Contentstack Marketplace?

Contentstack’s App Marketplace for Extensions is a platform where users can find and install pre-built extensions that can enhance the functionality of their Contentstack projects. These extensions are developed by Contentstack partners or third-party developers and are designed to simplify and streamline common development tasks, such as integrating with external systems, automating workflows, and adding new features to the CMS.Here are the key features of Contentstack’s App Marketplace for Extensions:1. Extension Types: The App Marketplace offers a variety of extensions types, including field types, custom widgets, and integrations. Each extension type has a specific purpose and can be used to enhance the functionality of the CMS in different ways. &nbsp;This includes Dashboard widgets, full-page apps, custom fields, sidebar widgets, rich-text field extensions and a new field modifier.2. Categories: The App Marketplace offers extensions across multiple categories, including SEO, localization, analytics, integrations, and more. These categories make it easy for users to find extensions that fit their specific needs.3. <a href="https://www.contentstack.com/docs/developers/developer-hub/get-started-with-building-apps-using-contentstack-app-sdk/">Developer Documentation</a>: Each extension in the App Marketplace comes with detailed documentation, which provides instructions on how to install, configure, and use the extension.4. &nbsp;The Developer Hub allows developers to upload their extensions to Contentstack and test them out. Additionally, developers can create private extensions for their customers and leverage the Developer Hub to make them accessible.5. Submit Your Own Extension: Developers can submit their own extensions to the App Marketplace. Contentstack reviews each extension to ensure that it meets quality standards before making it available in the marketplace. &nbsp;Using the Developer Hub you can createOverall, Contentstack’s App Marketplace for Extensions provides a centralized location for users to find and install extensions that can enhance the functionality of their Contentstack projects. With a wide range of extensions available across multiple categories, users can customize their CMS to fit their specific needs and streamline their workflows.<h2>Exercise:&nbsp;Installing and Using Apps from the Marketplace</h2>In this module we are going to install two apps from the Marketplace that support developers using Contentstack.1.&nbsp; Developer Tools2.&nbsp; Content Type Visualizer<h2>Installing Developer Tools</h2>Developer tools allow the developer to view the Entry JSON before it is published.&nbsp; This is very helpful when building apps and looking for the structure and properties of the content type.1.&nbsp; Go to the <a href="https://app.contentstack.com/#!/marketplace/apps">Marketplace dashboard</a>&nbsp; (<a href="https://eu-app.contentstack.com/#!/marketplace/apps">EU Marketplace Dashboard</a>)2.&nbsp; Select&nbsp;Developer Tools, Install App, and choose the Stack of where to install it <img src="https://learnupon.s3.eu-west-1.amazonaws.com/576446/original/bdc0e3af-7d8b-4c59-a74d-f3a51d7da1c3-Screen_Shot_2023-05-01_at_6.07.28_PM.png" width="100"/> <h2>Installing the Content Type Visualizer</h2>The Content Type Visualizer is another developer-friendly extension that shows the relationships between Content Types.&nbsp; It is installed on the Dashboard using the Marketplace.1.&nbsp; Go to the <a href="https://app.contentstack.com/#!/marketplace/apps">Marketplace dashboard</a>&nbsp; (<a href="https://eu-app.contentstack.com/#!/marketplace/apps">EU Marketplace Dashboard</a>)2.&nbsp; Select&nbsp;Content Type Visualizer, Install App, and choose the Stack of where to install it <img src="https://learnupon.s3.eu-west-1.amazonaws.com/576447/original/f814d925-6238-49a4-9907-8793ab8c4b58-Screen_Shot_2023-05-01_at_6.10.14_PM.png" width="100"/><div style="position: relative;overflow: hidden;padding-bottom: 56.25%;"><iframe src="https://cdn.jwplayer.com/players/TZemBvJ6-b769H14u.html" width="100%" height="100%" frameborder="0" scrolling="auto" title="Dev-marketplace App Install Dev Tools And Content Type Visualizer" style="position: absolute;" allowfullscreen=""></iframe></div>

Using Marketplace Apps

Installing and Configuring the NextJS Starter App&nbsp;About Starter Apps In Contentstack, starter apps are pre-built applications that demonstrate the capabilities of Contentstack&nbsp;and provide a starting point for developers learning about and building web applications.Starter apps are designed to be fully functional, customizable, and extensible, providing developers with a set of best practices and common patterns for building web applications that consume content from Contentstack.Starter apps in Contentstack are available for a variety of programming languages and frameworks, including NextJS, React, Angular, and Vue.js. Each starter app includes a set of pre-built content types, entries, assets, and environments.Using starter apps in Contentstack provides several benefits, including:<ul><li>Rapid prototyping: Starter apps provide a quick way to prototype and test new ideas, allowing developers to create a fully functional application in a fraction of the time it would take to build from scratch. &nbsp;</li><li>Best practices: Starter apps are built using best practices and industry-standard patterns, providing developers with a solid foundation for building scalable, maintainable, and high-performing applications.</li><li>Customization: Starter apps can be fully customized to meet the specific needs of the application being developed, including branding, layout, functionality, and integrations with other systems.</li><li>Extensibility: Starter apps can be extended and allowing developers to add new features and functionality as needed.</li></ul>Overall, starter apps in Contentstack provide a powerful and flexible way for developers to jumpstart their projects, reduce development time and costs, and ensure high-quality, scalable, and maintainable applications.<img src="https://learnupon.s3.eu-west-1.amazonaws.com/576412/original/d7095172-d3e3-4174-8502-19dcc4086a7c-Screen_Shot_2023-04-28_at_9.11.59_AM.png" width="100"/><h2>Three ways to get started with the StarterApps</h2>When starting to develop with Contentstack, we can install and use an existing NextJS Starter App called Logoipsum and this can be set up in several ways: &nbsp;1.&nbsp; The first approach involves using an <a href="https://www.contentstack.com/docs/developers/cli/bootstrap-starter-apps/">automated bootstrap CLI script</a> to generate a new Stack or load content into an existing Stack. This method includes all the default content and downloads the NextJS app. We will be using this option for the course.2.&nbsp; The second approach involves installing a Starter App via the Marketplace. This method is useful when you want to try using Contentstack as an Author or Editor and publish content without accessing the frontend code. However, we will not be using this approach in the course.3.&nbsp; <a href="https://www.contentstack.com/docs/developers/sample-apps/build-a-starter-website-using-next-js-and-contentstack/#import-content">Manually import the content with the CLI</a> and download the <a href="https://github.com/contentstack/contentstack-nextjs-starter-app">StarterApp from the Github repo</a> and manually configure the application.&nbsp; This does the same thing as step 1, but requires more time.<h2>Install the Starter App</h2><h3>Create the Stack</h3>To get started we will need to create a new Stack in Contentstack for our NextJS Starter app. &nbsp;To create our Starter App using the Contentstack CMS, we need to follow a few steps. Firstly, we need to create a new Stack and then use a CLI command to import the Starter app content and code. It is crucial to ensure that you have an Empty Stack ready for the StarterApp before proceeding. If you have the role of Organization Owner in Contentstack, then the CLI can create the Stack for you automatically using your login credentials.Watch the following video to explain how to install the StarterApp with the CLI<div style="position: relative;overflow: hidden;padding-bottom: 56.25%;"><iframe src="https://cdn.jwplayer.com/players/IbfbzKwm-b769H14u.html" width="100%" height="100%" frameborder="0" scrolling="auto" title="Dev-create A New Nextjs Starter App Via Cli" style="position: absolute;" allowfullscreen=""></iframe></div><h2>What’s inside the Starter App</h2> The Starter app Stack contains all the Content Types, Entries, Assets, Environments, Tokens, and Roles for a full website. &nbsp;The following video will explain the Starter app and where everything is located:<div style="position: relative;overflow: hidden;padding-bottom: 56.25%;"><iframe src="https://cdn.jwplayer.com/players/ZZQuG80V-b769H14u.html" width="100%" height="100%" frameborder="0" scrolling="auto" title="Dev-starter App Content Types Walkthrough & Token Explanation Ui Code Nextjs App" style="position: absolute;" allowfullscreen=""></iframe></div><h1>Architecture</h1><h2>Big Picture Architecture Diagram</h2><h3>Backend</h3>The Backend of Contentstack is the CMS with the ability to create and publish content.&nbsp; The focus here is on editor ease-of-use by providing a simple, powerful and flexible UI for content creation and management.&nbsp; In addition to the out of the box functionality, we also provide an ability to extend the interface by creating UI Extensions using our App SDK and connect to 3rd-party applications such as DAM providers, Analytics, E-Commerce platforms and more.<h3> </h3><h3>Frontend</h3>The focus on the frontend is high-performance for your website and web application. APIs and SDKs are provided to the developer for using in their applications to perform read-only queries to the content.&nbsp; The Content Delivery APIs use an internal CDN to cache all queries to the platform which results in higher performance for all your web applications.&nbsp; This is also where we find the Images API for delivering image assets.Watch this video that explains the big picture architecture:<div style="position: relative;overflow: hidden;padding-bottom: 56.25%;"><iframe src="https://cdn.jwplayer.com/players/gu1hi4sL-b769H14u.html" width="100%" height="100%" frameborder="0" scrolling="auto" title="Dev-big Picture Architecture" style="position: absolute;" allowfullscreen=""></iframe></div><img src="https://learnupon.s3.eu-west-1.amazonaws.com/576413/original/28c85d0f-f6ed-4644-bde9-f947fc9c37ac-Big-picture_Contentstack_Architecture_Diagram_2x-generic.png" width="100"/><h2> </h2><h2>Environments</h2><ul><li>One Stack can publish to multiple Environments. &nbsp;Think of Environments as “publish destinations”.</li><li>Each Environment has one Delivery Token, otherwise known as an Access Token. &nbsp;That token is unique per Environment.</li><li>Each Stack has an API key. &nbsp;There is only 1 API key per Stack and it is unique.</li><li>Most API calls will require both an API token and a Delivery / Access Token. </li></ul>Watch this video to understand how we use Environments in Contentstack:<div style="position: relative;overflow: hidden;padding-bottom: 56.25%;"><iframe src="https://cdn.jwplayer.com/players/xDslMX1l-b769H14u.html" width="100%" height="100%" frameborder="0" scrolling="auto" title="Dev-environments" style="position: absolute;" allowfullscreen=""></iframe></div>The following diagram for Environments illustrates these concepts:<img src="https://learnupon.s3.eu-west-1.amazonaws.com/576414/original/af295889-db78-4a87-aa40-5e077862b3ad-Environments_2x.png" width="100"/>
 
 <h2><h3>Multi-Stack Architecture Diagram
 </h3><img src="https://lh5.googleusercontent.com/bIvhDECh5mzOrfGNMxSTy-k4EFx7yRO3U5Z5MkFAQ3neVQ1yUP3i15JA-UP88Br9YT5jNUX6BfkST6uZ-nuBlw76G9zULLu-0_u-fVAvdCtQXyJy6UJWX4Govx_fXLXHKSIQvgJgAWMtY-PrKSLtFWY" width="100"/></h2>

Installing the NextJS Starter App with the CLI

<h1></h1><ul><li><a href="http://community.contentstack.com">Contentstack Community</a></li><li><a href="https://www.contentstack.com/docs/developers/">Developer Documentation Portal</a></li></ul><h2>Helpful Documentation Links</h2><h3>APIs</h3><ul><li><a href="https://www.contentstack.com/docs/developers/apis/">APIs Homepage</a></li><li><a href="https://www.contentstack.com/docs/developers/apis/postman-collections/">Postman Collections for APIs</a></li><li><a href="https://www.contentstack.com/docs/developers/cli/">CLI</a></li><li><a href="https://www.contentstack.com/docs/developers/sdks/utils-sdk/javascript/get-started-with-javascript-utils-library/">JavaScript RTE&nbsp;Parsing Utils</a></li><li><a href="https://github.com/contentstack/json-rte-serializer/">JSON RTE Serializer - Github</a></li></ul><h3>Sample Apps / Examples</h3><ul><li><a href="https://www.contentstack.com/docs/developers/sample-apps/">Sample Apps</a></li><li><a href="https://github.com/Contentstack-Solutions/contentstack-nextjs-typescript-base/blob/main/lib/services/contentstack-service.ts">Contentstack Typescript Query / API Service</a></li><li><a href="https://github.com/Contentstack-Solutions/contentstack-nextjs-typescript-base/blob/main/lib/services/contentstack-service.ts">https://github.com/Contentstack-Solutions/contentstack-nextjs-typescript-base/blob/main/lib/services/contentstack-service.ts</a></li><li><a href="https://github.com/Contentstack-Solutions">Contentstack Solutions Github Repo</a></li></ul><h3>Live Preview</h3><ul><li><a href="https://www.contentstack.com/docs/content-managers/author-content/live-preview-real-world-scenarios/">Live Preview Real-world scenarios</a></li><li><a href="https://www.contentstack.com/docs/developers/set-up-live-preview/how-live-preview-works-with-sdk/">How Live Preview Works with the SDK</a></li><li><a href="https://www.contentstack.com/docs/developers/set-up-live-preview/">Set up Live Preview&nbsp;</a></li></ul><ul></ul>

Helpful Resources

The Contentstack Developer Onboarding Course is designed to equip learners with comprehensive knowledge on various aspects of the platform, including its architecture, APIs, SDKs, and the process of creating a NextJS web application.&nbsp; <a href="https://github.com/contentstack/contentstack-academy-playground" target="_blank">Download Playground Here</a>You can also install a training instance by visiting our Legacy Academy. Click the <a href="https://www.contentstack.com/academy-old" target="_blank">Create Training Instance</a> button on the home page.Throughout the course, learners will receive detailed instruction on how to utilize Contentstack's features to build robust and scalable web applications. They will gain a deep understanding of the platform's architecture, enabling them to develop applications that take full advantage of Contentstack's capabilities.&nbsp;Additionally, the course will provide learners with hands-on experience using Contentstack's APIs and SDKs, enabling them to develop efficient and effective web applications. By the end of the course, learners will be equipped with the skills and knowledge necessary to create high-quality web applications using Contentstack.

The Contentstack Developer Onboarding Course is designed to equip learners with comprehensive knowledge on various aspects of the platform, including its architecture, APIs, SDKs, and the process of creating a NextJS web application. 

Contentstack for Developers

cs-for-devs2.png

Environments

This quick video reviews how environments work in Contentstack

Understanding Environments

environments-thumbnail.png

Master environments in Contentstack Academy to streamline your content management and ensure smooth transitions from development to production.

<h3>Personalize </h3> At Contentstack we believe Composable Digital Experience Platforms should be easier. Headless should be powerful AND intuitive. Products should be built to be connected. When it comes to personalization with other platforms, adoption is typically difficult, editing is confusing, and implementations are complex.&nbsp;But here at Contentstack we want you to be able to tell the right story to the right people, at the right time. Introducing Contentstack Personalize.

Personalize Demo

This short video will demonstrate the capabilities of Personalize.

Contentstack Personalize

Personalize.svg

Get a tailored experience with our personalized demo and discover how Contentstack can meet your unique needs and streamline your content management.

Understanding Taxonomy

Understand the Taxonomy feature in the Contentstack CMS.

Understanding Taxonomy in Contentstack

understanding-taxonomy.png

Master content organization with our guide on understanding taxonomy in Contentstack Academy; optimize your content structure and enhance efficiency.

Search 2.0

This video describes the search capabilities within the Contentstack CMS

Learn how to search in Contentstack

search.png

Using Search

Master the art of searching with Contentstack Academy's guide and learn to efficiently find and filter content with advanced search techniques.

<h2>AI Accelerator </h2>We’re excited to help you discover the power of Generative AI and integrate it strategically within your Contentstack workflows. Watch this video to learn more about our AI Accelerator program!

Ai-accelerator

AI Accelerator 

about-accelerator.svg

AI Accelerator

Contentstack Brand Kit is a one-stop-shop for managing and showcasing your brand’s unique identity. It allows you to centralize your brand voice, guidelines, and communication styles. Within a&nbsp;<a href="https://www.contentstack.com/docs/content-managers/brand-kit/about-brand-kit">Brand Kit</a>, you can define your brand’s distinct voice through customizable&nbsp;<a href="https://www.contentstack.com/docs/content-managers/brand-kit/about-voice-profile">Voice Profiles</a>&nbsp;and leverage integrated AI capabilities to generate on-brand content seamlessly. You can also easily consolidate and organize your brand’s knowledgebase in the&nbsp;<a href="https://www.contentstack.com/docs/content-managers/brand-kit/about-knowledge-vault">Knowledge Vault</a>&nbsp;and maintain brand integrity. Brand Kit seamlessly integrates with the&nbsp;<a href="https://www.contentstack.com/docs/developers/marketplace-apps/ai-assistant-with-brand-kit">Marketplace AI Assistant</a>&nbsp;app. Install the app from our Marketplace, select your Brand Kit and Voice Profile, and create AI-generated content using the prompt.Also, by using our&nbsp;<a href="https://www.contentstack.com/docs/developers/automation-hub-connectors/brand-kit">Automate Brand Kit Connector</a>, you perform Brand Kit specific actions, such as fetching the details of Voice Profiles and Knowledge Vault.

Brand-kit-demo

Contentstack Brand Kit is a one-stop-shop for managing and showcasing your brand’s unique identity. It allows you to centralize your brand voice, guidelines, and communication styles.

Contentstack Brand Kit Demo

brand-kit-demo.svg

Brand Kit Demo

Welcome to the Contentstack Academy - where you can learn all things Contentstack. We offer short-form content and longer formal courses. Whatever your learning style, we have material here for you to get the most out of Contentstack.

Academy-demo

Welcome to the Contentstack Academy - where you can learn all things Contentstack. We offer short-form content and longer formal courses. Whatever your learning style, we have material here for you to get the most out of Contentstack.

Explore

Personalize Foundations

Understanding Releases

Content Modeling with Contentstack

Contentstack for Developers

Understanding Environments

Personalize Demo

Understanding Taxonomy

Using Search

AI Accelerator

Brand Kit Demo

Contentstack Academy Demo

Understanding Timeline