Calling all developers! We invite you to provide your input on Feature Experimentation by completing this brief survey.

 

Hieu Nguyen
Dec 19, 2024
  391
(3 votes)

Simplify Optimizely CMS Configuration with JSON Schema

 

 

Optimizely CMS is a powerful and versatile platform for content management, offering extensive configuration options that allow developers to fine-tune their applications. However, navigating and correctly setting up these options in appsettings.json can sometimes feel daunting—especially for new developers or those unfamiliar with the full breadth of available settings.

To address this challenge, I’m excited to introduce the Optimizely JSON Schema. This schema is designed to streamline the configuration process for developers, providing them with an enhanced, developer-friendly experience in popular IDEs like Visual Studio Code and JetBrains Rider.


Why a JSON Schema?

When configuring Optimizely CMS, developers rely on appsettings.json to define their application's behavior. While the official Optimizely CMS documentation provides thorough information, manually looking up settings and ensuring their correctness can slow down development and increase the risk of errors.

Here’s how the Optimizely JSON Schema helps:

  • Autocomplete Support: Provides autocomplete suggestions for configuration keys, reducing the need to memorize or constantly refer to external documentation.
  • Validation on the Fly: Highlights invalid or unsupported configuration keys and values, ensuring your appsettings.json is always accurate.
  • Inline Documentation: Displays descriptions and valid values for settings directly in the IDE, offering context as you type.
  • Consistent Structure: Encourages adherence to best practices in structuring and naming settings.

Features of the Optimizely JSON Schema

  1. Comprehensive Coverage of Optimizely CMS Settings
    The schema encapsulates all documented configuration options for Optimizely CMS, based on the official Optimizely Configuration Documentation. More options will be added in future (e.g: eCommerce).

  2. IDE Integration
    It works seamlessly with IDEs that support JSON Schema, such as:

    • Visual Studio Code
    • JetBrains Rider
    • Visual Studio
  3. Quick Start Setup
    Simply download here and reference the schema in your appsettings.json file:

    {
        "$schema": "appsettings-schema.json",
        ...
    }
    

Benefits for Developers

  • Faster Configuration: Save time with instant suggestions and error-checking.
    Image image.png

  • Error Reduction: Minimize misconfigurations that could lead to runtime errors.


  • Improved Developer Experience: Eliminate the constant back-and-forth between code and documentation.

How to Get Started

  1. Install the schema: Head over to the GitHub repository  to download JSON Schema.

  2. Reference the Schema: Add the schema URL to your appsettings.json file as shown in the example above.

  3. Explore Settings: Start typing in your configuration file to experience the power of autocompletion, validation, and inline documentation.

  4. Contribute: Found an undocumented configuration or want to improve the schema? Feel free to submit issues or pull requests to the GitHub repository.


Release Changes

12/12/2024: Initial Schema (Version 1.0)

  • Launched the first version of the JSON Schema.

  • Included all major configuration options for Optimizely CMS based on official documentation.

  • Added support for autocomplete, validation, and inline documentation in JSON editors.

01/10/2025: Refactor and Optimize Schema (Version 1.1)

  • Refactored the schema to improve performance and readability.

  • Optimized the structure for better autocomplete suggestions.

  • Enhanced validation rules to catch edge cases and unsupported values more effectively.


Conclusion

The Optimizely JSON Schema is here to make your life as an Optimizely developer easier. By integrating the schema into your IDE, you’ll spend less time searching through documentation and more time building great experiences with Optimizely CMS.

Feel free to share your feedback and suggestions in the comments below or on the project’s GitHub page. Let’s make working with Optimizely CMS configurations smoother than ever!

Dec 19, 2024

Comments

Eric Petersson
Eric Petersson Dec 20, 2024 07:36 AM

This is great Hieu!

Will this schema-file be part of the PaaS Nuget download or similar for Optimizely Cms 12 in the future? As a default installation of the product

Hieu Nguyen
Hieu Nguyen Dec 20, 2024 08:02 AM

Hi Eric, since this schema is just a tool for use in IDEs, it's best to download it directly from GitHub and add it to your projects.

However, if you find that installing it via NuGet would be more convenient, I can publish it next week.

Please login to comment.
Latest blogs
Optimizely Content Graph on mobile application

CG everywhere! I pull schema from our default index https://cg.optimizely.com/app/graphiql?auth=eBrGunULiC5TziTCtiOLEmov2LijBf30obh0KmhcBlyTktGZ in...

Cuong Nguyen Dinh | Jan 20, 2025

Image Analyzer with AI Assistant for Optimizely

The Smart Image Analyzer is a new feature in the Epicweb AI Assistant for Optimizely CMS that automates the management of image metadata, such as...

Luc Gosso (MVP) | Jan 16, 2025 | Syndicated blog

How to: create Decimal metafield with custom precision

If you are using catalog system, the way of creating metafields are easy – in fact, you can forget about “metafields”, all you should be using is t...

Quan Mai | Jan 16, 2025 | Syndicated blog

Level Up with Optimizely's Newly Relaunched Certifications!

We're thrilled to announce the relaunch of our Optimizely Certifications—designed to help partners, customers, and developers redefine what it mean...

Satata Satez | Jan 14, 2025

Introducing AI Assistance for DBLocalizationProvider

The LocalizationProvider for Optimizely has long been a powerful tool for enhancing the localization capabilities of Optimizely CMS. Designed to ma...

Luc Gosso (MVP) | Jan 14, 2025 | Syndicated blog

Order tabs with drag and drop - Blazor

I have started to play around a little with Blazor and the best way to learn is to reimplement some old stuff for CMS12. So I took a look at my old...

Per Nergård (MVP) | Jan 14, 2025