# CivicTheme ## Docs - [Introduction](https://docs.civictheme.io/getting-started/readme.md): Welcome to CivicTheme! CivicTheme is an open-source, government-grade design system led by open-governance with a vision. - [Getting help](https://docs.civictheme.io/getting-started/getting-help.md) - [Security framework](https://docs.civictheme.io/getting-started/security-policy.md) - [Security update - 1.12.0](https://docs.civictheme.io/getting-started/civictheme-1.12.0-manual-update-instructions.md) - [Partnerships](https://docs.civictheme.io/getting-started/partnerships.md): Interested in significant contributions or deployments of CivicTheme? Learn more here. - [GovCMS SaaS](https://docs.civictheme.io/playbook/govcms.md) - [Installation](https://docs.civictheme.io/playbook/govcms/01-installation.md) - [Setting Up Your Sub-Theme](https://docs.civictheme.io/playbook/govcms/02-sub-theme-setup.md) - [Configuring Colors and Theme Settings](https://docs.civictheme.io/playbook/govcms/03-colors-and-settings.md) - [Overriding Existing Components](https://docs.civictheme.io/playbook/govcms/04-overriding-components.md) - [Creating New Components](https://docs.civictheme.io/playbook/govcms/05-creating-components.md) - [Updating Packages](https://docs.civictheme.io/playbook/govcms/06-updating-packages.md) - [Security Updates](https://docs.civictheme.io/playbook/govcms/07-security-updates.md) - [Drupal Community](https://docs.civictheme.io/playbook/drupal.md) - [Installation](https://docs.civictheme.io/playbook/drupal/01-installation.md) - [Drupal theme](https://docs.civictheme.io/installation/drupal-theme.md) - [GovCMS SaaS](https://docs.civictheme.io/installation/govcms-saas.md) - [GovCMS automated installation](https://docs.civictheme.io/installation/govcms-saas/govcms-saas-automated.md) - [GovCMS manual installation](https://docs.civictheme.io/installation/govcms-saas/govcms-saas-manual.md) - [GovCMS content provisioning](https://docs.civictheme.io/installation/govcms-saas/govcms-content-provisioning.md) - [GovCMS post installation cleanup](https://docs.civictheme.io/installation/govcms-saas/govcms-post-installation-cleanup.md) - [UI kit](https://docs.civictheme.io/development/uikit.md) - [Components](https://docs.civictheme.io/development/uikit/variables.md) - [Spacing](https://docs.civictheme.io/development/uikit/variables/spacing.md) - [Grid](https://docs.civictheme.io/development/uikit/variables/grid.md) - [Typography](https://docs.civictheme.io/development/uikit/variables/typography.md) - [Overriding components](https://docs.civictheme.io/development/uikit/variables/overriding-components.md) - [Creating components](https://docs.civictheme.io/development/uikit/variables/creating-components.md) - [Drupal theme](https://docs.civictheme.io/development/drupal-theme.md): Documentation for developing and customising CivicTheme for Drupal - [Sub-theme](https://docs.civictheme.io/development/drupal-theme/sub-theme.md) - [Color selector](https://docs.civictheme.io/development/drupal-theme/color-selector.md) - [Header](https://docs.civictheme.io/development/drupal-theme/header.md) - [Footer](https://docs.civictheme.io/development/drupal-theme/footer.md) - [Namespaces](https://docs.civictheme.io/development/drupal-theme/namespaces.md) - [Templates](https://docs.civictheme.io/development/drupal-theme/templates.md) - [Assets](https://docs.civictheme.io/development/drupal-theme/assets.md) - [Layout builder](https://docs.civictheme.io/development/drupal-theme/layout-builder.md) - [Menus](https://docs.civictheme.io/development/drupal-theme/menus.md) - [Automated list](https://docs.civictheme.io/development/drupal-theme/automated-list.md) - [Systems](https://docs.civictheme.io/development/drupal-theme/systems.md) - [Build System](https://docs.civictheme.io/development/drupal-theme/systems/build.md) - [Colors](https://docs.civictheme.io/development/drupal-theme/systems/colors.md) - [Components](https://docs.civictheme.io/development/drupal-theme/systems/components.md) - [Mapping](https://docs.civictheme.io/development/drupal-theme/systems/mapping.md) - [Maintenance](https://docs.civictheme.io/development/maintenance.md): Documentation about maintaining the CivicTheme codebase - [Code naming conventions](https://docs.civictheme.io/development/maintenance/code-naming-conventions.md) - [Requirements and constraints](https://docs.civictheme.io/development/maintenance/requirements-and-constraints.md) - [Authoring documentation](https://docs.civictheme.io/development/maintenance/authoring-documentation.md) - [Generic page example](https://docs.civictheme.io/development/maintenance/authoring-documentation/generic-page-example.md) - [Content component page example](https://docs.civictheme.io/development/maintenance/authoring-documentation/content-component-page-example.md) - [Code of conduct](https://docs.civictheme.io/contributing/code-of-conduct.md): The CivicTheme Code of conduct promotes a respectful, inclusive environment for all contributors. It outlines acceptable behaviour, participation guidelines, and steps for addressing conflicts. - [Contribution model](https://docs.civictheme.io/contributing/contribution-model.md): This is the central guide on how to contribute to CivicTheme, be it code or design. - [Contribution basics](https://docs.civictheme.io/contributing/contribution-basics.md): This page outlines the basics for getting started with your contribution - [Small contribution spec](https://docs.civictheme.io/contributing/small-contribution-spec.md): The following page outlines the process of a light contribution to CivicTheme. - [Medium contribution spec](https://docs.civictheme.io/contributing/medium-contribution-spec.md): The following page outlines the process of a medium contribution to CivicTheme. - [Major (RFC-level) contribution spec](https://docs.civictheme.io/contributing/major-rfc-level-contribution-spec.md): The following page outlines the process of a major contribution to CivicTheme. - [Figma contributions](https://docs.civictheme.io/contributing/figma-contributions.md): This page outlines the process for contributing to the CivicTheme Figma UI Kit. - [Component list](https://docs.civictheme.io/components/component-list.md): See the list of components that CivicTheme supports right now. This list will grow as the community and adoption grows! - [Atoms](https://docs.civictheme.io/components/atoms.md): Atoms are the smallest component in an atomic design system. This page outlines their purpose. - [Button](https://docs.civictheme.io/components/atoms/button.md): A Button is an interactive element that triggers an action when clicked or tapped, providing a clear call-to-action for users. - [Chip](https://docs.civictheme.io/components/atoms/chip.md) - [Content link](https://docs.civictheme.io/components/atoms/content-link.md) - [Check box](https://docs.civictheme.io/components/atoms/check-box.md) - [Field description](https://docs.civictheme.io/components/atoms/field-description.md) - [Field message](https://docs.civictheme.io/components/atoms/field-message.md) - [Fieldset](https://docs.civictheme.io/components/atoms/fieldset.md) - [Label](https://docs.civictheme.io/components/atoms/label.md) - [Radio](https://docs.civictheme.io/components/atoms/radio.md) - [Select](https://docs.civictheme.io/components/atoms/select.md) - [Textarea](https://docs.civictheme.io/components/atoms/textarea.md) - [Text field](https://docs.civictheme.io/components/atoms/text-field.md) - [Heading](https://docs.civictheme.io/components/atoms/heading.md) - [Link](https://docs.civictheme.io/components/atoms/link.md) - [Paragraph](https://docs.civictheme.io/components/atoms/paragraph.md) - [Popover](https://docs.civictheme.io/components/atoms/popover.md) - [Quote](https://docs.civictheme.io/components/atoms/quote.md) - [Table](https://docs.civictheme.io/components/atoms/table.md) - [Tag](https://docs.civictheme.io/components/atoms/tag.md) - [Text list](https://docs.civictheme.io/components/atoms/text-list.md) - [Molecules](https://docs.civictheme.io/components/molecules.md) - [Accordion](https://docs.civictheme.io/components/molecules/accordion.md) - [Attachment](https://docs.civictheme.io/components/molecules/attachment.md) - [Breadcrumb](https://docs.civictheme.io/components/molecules/breadcrumb.md) - [Callout](https://docs.civictheme.io/components/molecules/callout.md) - [Event Card](https://docs.civictheme.io/components/molecules/event-card.md) - [Field](https://docs.civictheme.io/components/molecules/field.md) - [Figure](https://docs.civictheme.io/components/molecules/figure.md) - [Group filter](https://docs.civictheme.io/components/molecules/group-filter.md) - [Logo](https://docs.civictheme.io/components/molecules/logo.md) - [Map](https://docs.civictheme.io/components/molecules/map.md) - [Navigation card](https://docs.civictheme.io/components/molecules/navigation-card.md) - [Next step](https://docs.civictheme.io/components/molecules/next-step.md) - [Pagination](https://docs.civictheme.io/components/molecules/pagination.md) - [Promo card](https://docs.civictheme.io/components/molecules/promo-card.md) - [Search](https://docs.civictheme.io/components/molecules/search.md) - [Service card](https://docs.civictheme.io/components/molecules/service-card.md) - [Single filter](https://docs.civictheme.io/components/molecules/single-filter.md) - [Snippet](https://docs.civictheme.io/components/molecules/snippet.md) - [Subject Card](https://docs.civictheme.io/components/molecules/subject-card.md) - [Table of Contents](https://docs.civictheme.io/components/molecules/table-of-contents.md) - [Tabs](https://docs.civictheme.io/components/molecules/tabs.md) - [Tag List](https://docs.civictheme.io/components/molecules/tag-list.md) - [Tooltip](https://docs.civictheme.io/components/molecules/tooltip.md) - [Video Player](https://docs.civictheme.io/components/molecules/video-player.md) - [Organisms](https://docs.civictheme.io/components/organisms.md) - [Alert](https://docs.civictheme.io/components/organisms/alert.md) - [Banner](https://docs.civictheme.io/components/organisms/banner.md) - [Campaign](https://docs.civictheme.io/components/organisms/campaign.md) - [Footer](https://docs.civictheme.io/components/organisms/footer.md) - [Header](https://docs.civictheme.io/components/organisms/header.md) - [List](https://docs.civictheme.io/components/organisms/list.md) - [Message](https://docs.civictheme.io/components/organisms/message.md) - [Mobile Navigation](https://docs.civictheme.io/components/organisms/mobile-navigation.md) - [Navigation](https://docs.civictheme.io/components/organisms/navigation.md) - [Promo](https://docs.civictheme.io/components/organisms/promo.md) - [Side Navigation](https://docs.civictheme.io/components/organisms/side-navigation.md) - [Skip link](https://docs.civictheme.io/components/organisms/skip-link.md) - [Slider](https://docs.civictheme.io/components/organisms/slider.md) - [Social links](https://docs.civictheme.io/components/organisms/social-links.md) - [Overview](https://docs.civictheme.io/content-authoring/overview.md) - [Global settings](https://docs.civictheme.io/content-authoring/site-wide-configuration.md) - [Favicon](https://docs.civictheme.io/content-authoring/site-wide-configuration/favicon.md) - [Header](https://docs.civictheme.io/content-authoring/site-wide-configuration/header.md) - [Site slogan](https://docs.civictheme.io/content-authoring/site-wide-configuration/header/site-slogan.md) - [Header logos](https://docs.civictheme.io/content-authoring/site-wide-configuration/header/logo.md) - [Primary navigation](https://docs.civictheme.io/content-authoring/site-wide-configuration/header/navigation.md) - [Secondary navigation](https://docs.civictheme.io/content-authoring/site-wide-configuration/header/seconday-navigation.md) - [Banner](https://docs.civictheme.io/content-authoring/site-wide-configuration/banner-block.md): This article shows you how to create and edit the site-wide banner. - [Search](https://docs.civictheme.io/content-authoring/site-wide-configuration/search-block.md) - [Link](https://docs.civictheme.io/content-authoring/site-wide-configuration/link.md): Choose whether to open internal and external links in a new window, and learn how to override external link domains. - [Skip link](https://docs.civictheme.io/content-authoring/site-wide-configuration/skip-link.md): Select the Light or Dark theme for the Skip link section - [Side navigation](https://docs.civictheme.io/content-authoring/site-wide-configuration/side-navigation.md) - [Signup](https://docs.civictheme.io/content-authoring/site-wide-configuration/signup.md) - [Footer](https://docs.civictheme.io/content-authoring/site-wide-configuration/footer.md) - [Footer logo](https://docs.civictheme.io/content-authoring/site-wide-configuration/footer/footer-logo.md) - [Social links](https://docs.civictheme.io/content-authoring/site-wide-configuration/footer/social-links-block.md): Learn how to use the Social links custom block to link to your social media platforms - [Footer navigation](https://docs.civictheme.io/content-authoring/site-wide-configuration/footer/footer-navigation.md) - [Acknowledgement of Country](https://docs.civictheme.io/content-authoring/site-wide-configuration/footer/acknowledgement-of-country.md) - [Copyright](https://docs.civictheme.io/content-authoring/site-wide-configuration/footer/copyright.md) - [Colours](https://docs.civictheme.io/content-authoring/site-wide-configuration/colours.md) - [Content types](https://docs.civictheme.io/content-authoring/content.md) - [Page](https://docs.civictheme.io/content-authoring/content/page-content-type.md): This article outlines basic configuration for the Page content type. - [Configure the banner](https://docs.civictheme.io/content-authoring/content/page-content-type/configure-the-banner.md): This article outlines how to configure the banner on a per-page basis, overriding the site-wide banner settings. - [Event](https://docs.civictheme.io/content-authoring/content/event-content-type.md) - [Alert](https://docs.civictheme.io/content-authoring/content/alert.md) - [Content components](https://docs.civictheme.io/content-authoring/components.md) - [Accordion](https://docs.civictheme.io/content-authoring/components/accordion.md) - [Attachment](https://docs.civictheme.io/content-authoring/components/attachment.md) - [Callout](https://docs.civictheme.io/content-authoring/components/callout.md) - [Campaign](https://docs.civictheme.io/content-authoring/components/campaign.md) - [Content](https://docs.civictheme.io/content-authoring/components/content.md) - [Quote](https://docs.civictheme.io/content-authoring/components/content/quote.md) - [iFrame](https://docs.civictheme.io/content-authoring/components/iframe.md): Learn how to add an iFrame to any CivicTheme page. - [List components and cards](https://docs.civictheme.io/content-authoring/components/list-components-and-cards.md) - [Automated list](https://docs.civictheme.io/content-authoring/components/list-components-and-cards/automated-list.md) - [Manual List](https://docs.civictheme.io/content-authoring/components/list-components-and-cards/manual-list.md) - [Cards for lists](https://docs.civictheme.io/content-authoring/components/list-components-and-cards/cards-for-lists.md) - [Event card](https://docs.civictheme.io/content-authoring/components/list-components-and-cards/cards-for-lists/event-card.md) - [Event reference card](https://docs.civictheme.io/content-authoring/components/list-components-and-cards/cards-for-lists/event-reference-card.md) - [Navigation card](https://docs.civictheme.io/content-authoring/components/list-components-and-cards/cards-for-lists/navigation-card.md) - [Navigation reference card](https://docs.civictheme.io/content-authoring/components/list-components-and-cards/cards-for-lists/navigation-reference-card.md) - [Promo card](https://docs.civictheme.io/content-authoring/components/list-components-and-cards/cards-for-lists/promo-card.md) - [Promo reference card](https://docs.civictheme.io/content-authoring/components/list-components-and-cards/cards-for-lists/promo-reference-card.md) - [Publication card](https://docs.civictheme.io/content-authoring/components/list-components-and-cards/cards-for-lists/publication-card.md) - [Service card](https://docs.civictheme.io/content-authoring/components/list-components-and-cards/cards-for-lists/service-card.md) - [Snippet](https://docs.civictheme.io/content-authoring/components/list-components-and-cards/cards-for-lists/snippet.md) - [Snippet reference card](https://docs.civictheme.io/content-authoring/components/list-components-and-cards/cards-for-lists/snippet-reference-card.md) - [Subject card](https://docs.civictheme.io/content-authoring/components/list-components-and-cards/cards-for-lists/subject-card.md) - [Subject reference card](https://docs.civictheme.io/content-authoring/components/list-components-and-cards/cards-for-lists/subject-reference-card.md) - [Map](https://docs.civictheme.io/content-authoring/components/map.md) - [Message](https://docs.civictheme.io/content-authoring/components/message.md) - [Next step](https://docs.civictheme.io/content-authoring/components/next-step.md) - [Promo](https://docs.civictheme.io/content-authoring/components/promo.md): This page is in development. - [Slider](https://docs.civictheme.io/content-authoring/components/slider.md) - [Webform](https://docs.civictheme.io/content-authoring/components/webform.md) - [Vocabularies](https://docs.civictheme.io/content-authoring/vocabularies.md) - [Topics](https://docs.civictheme.io/content-authoring/vocabularies/topics.md) - [Site sections](https://docs.civictheme.io/content-authoring/vocabularies/site-sections.md) - [User accounts & roles](https://docs.civictheme.io/content-authoring/user-accounts-and-roles.md): Create new users and assign roles ## Changelog - [CivicTheme 1.12.0](https://docs.civictheme.io/changelog/civictheme-release-notes/civictheme-1.12.0.md): Version 1.12.0 was released on October 23, 2025. - [CivicTheme 1.11.0](https://docs.civictheme.io/changelog/civictheme-release-notes/civictheme-1.11.0.md): Version 1.11.0 was released on May 27, 2025. - [CivicTheme 1.10.0](https://docs.civictheme.io/changelog/civictheme-release-notes/civictheme-1.10.0.md): Version 1.10 was released on March 25, 2025. - [CivicTheme 1.9.0](https://docs.civictheme.io/changelog/civictheme-release-notes/civictheme-1.9.0.md): Version 1.9 was released on December 4, 2024. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on a page URL with the `ask` query parameter: ``` GET https://docs.civictheme.io/getting-started/readme.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.