orchardcore-site-settings

Configure Orchard Core site settings with CustomSettings and recipe steps.

13|3|Updated Feb 6, 2026
One-click install
npx skills add https://github.com/CrestApps/CrestApps.AgentSkills --skill orchardcore-site-settings
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: orchardcore-site-settings
Source: https://github.com/CrestApps/CrestApps.AgentSkills/tree/main/src/CrestApps.AgentSkills.Skills/orchardcore/orchardcore-site-settings
Command: npx skills add https://github.com/CrestApps/CrestApps.AgentSkills --skill orchardcore-site-settings

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This skill helps developers configure and extend Orchard Core site-level settings, exposing both built-in properties and custom settings through a structured, admin-facing workflow.

Core Features & Use Cases

  • Read and write core site properties such as SiteName, BaseUrl, TimeZoneId, Culture, PageSize, and UseCdn via ISiteService.
  • Define custom settings sections using the CustomSettings stereotype and render them with a Site-level DisplayDriver to appear in the admin UI.
  • Configure both built-in and custom settings with recipe steps, and add admin navigation entries to manage each section securely.

Quick Start

Create a custom settings section with the CustomSettings stereotype, wire a Site settings display driver, and configure built-in and custom site settings using Orchard Core recipes.

Frequently Asked Questions about orchardcore-site-settings

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I add custom site settings to the Orchard Core admin UI?

Add custom site settings in Orchard Core by defining a content type using the CustomSettings stereotype and rendering it with a Site-level DisplayDriver. This exposes your custom configuration section directly within the standard admin navigation workflow.

Can I configure Orchard Core site properties like SiteName and BaseUrl using recipes?

Yes, you can configure built-in Orchard Core site properties like SiteName, BaseUrl, and TimeZoneId using recipe steps. Recipes allow you to automate the setup of both core and custom site settings during deployment.

What is the CustomSettings stereotype used for in Orchard Core?

The CustomSettings stereotype in Orchard Core defines custom site-level configuration sections. It lets developers create distinct admin settings pages securely managed through ISiteService, IContentDefinitionManager, and specific permission controls.

How do I manage admin navigation and permissions for custom site settings?

Manage admin navigation for custom settings by implementing an INavigationProvider to add menu entries. Secure these sections by applying permission controls that verify admin access before reading or writing settings via ISiteService.

Which services do I need to read and write built-in Orchard Core site properties?

Read and write built-in Orchard Core site properties like Culture, PageSize, and UseCdn by injecting ISiteService. Use a SiteSettingsDisplayDriver to integrate these properties into the admin UI for management.

Does extending site settings in Orchard Core require IContentDefinitionManager?

Yes, extending site settings requires IContentDefinitionManager to define the CustomSettings stereotype. It works alongside ISiteService and SiteSettingsDisplayDriver to render and persist the custom configuration sections.