Skip to main content
New in 4.1: color palettes and a palette picker. See the themes

ContactPage

Osirion Team Last updated: oktobar 17, 2026

ContactPage renders a whole contact page: the title as the page's h1, an optional Markdown introduction from the content item with the slug contact, and an OsirionContactForm with your contact details beside it. It works without that item, from Title and Description; with it, the text is edited in Markdown and the page writes ContactPage structured data.

Package Osirion.Blazor.Cms.Web, namespace Osirion.Blazor.Cms.Web.Components. Source on GitHub.

There is no live demo on this page. ContactPage writes the page's title and description into the head, and its form would either send a message or pretend to. Open the contact page of this site to see it.

Usage

The contact page of the example site: no content item, a description for the head and the page, and the library's email service behind the form:

@page "/contact"
@using Osirion.Blazor.Cms.Web.Components
@using Osirion.Blazor.Core.Models

<ContactPage Description="Questions, bug reports and ideas for the next release."
             FormTitle="Get in touch"
             FormDescription="Have a question? Write to us."
             ContactInfo="contactInfo"
             UseBuiltInEmailService />

@code {
    private readonly ContactInformation contactInfo = new()
    {
        Address = "Belgrade, Serbia",
        Website = "https://example.com"
    };
}

To handle the message yourself, leave UseBuiltInEmailService off and set OnSubmit, which receives a ContactFormModel for every valid submission. To use a form of your own, or an OsirionContactForm configured beyond these parameters, pass it as FormContent. How the form validates and how the built-in email service is configured is described on the OsirionContactForm page.

Add a content item with the slug contact (a contact.md file) to write the introduction in Markdown: its title replaces Title, its description replaces Description, and its body is shown above the form.

Parameters

ContactPage takes the lookup parameters of OsirionContentItemPageBase (Item, ItemPath, ItemUrl, ItemSlug, Query, Locale, DirectoryName) and the hero and SEO parameters of the page base. ItemSlug defaults to contact and ShowHero to false, which the constructor sets.

Parameter Type Default Description
Title string "Contact" The title used when there is no content item. Defaults to Contact.
Description string? null The sentence under the title, also the meta description, used when there is no content item.
FormId string "contact-page-form" The form's id, which also names the form for static server-side rendering. Defaults to contact-page-form.
FormTitle string "Write to us" The heading of the form. Defaults to Write to us.
FormDescription string "" The text under the form's heading.
ContactInfo ContactInformation? null The address, phone, email and website shown beside the form. Nothing is shown beside it when null.
UseBuiltInEmailService bool false Whether the form sends its messages with the library's email service (configured with AddOsirionEmailServices). Defaults to false; handle OnSubmit instead.
OnSubmit EventCallback<ContactFormModel> - The callback that receives a valid submission.
FormContent RenderFragment? null A form that replaces the built-in one, for an OsirionContactForm configured beyond these parameters or a form of your own.
ChildContent RenderFragment? null Content shown after the form, for example office hours or a map link.
Item ContentItem? null The item to show. When you set it, the page shows it and loads nothing; otherwise the page finds the first match of OsirionContentPageBase.Query or of the ItemPath, ItemUrl, ItemSlug, locale and directory parameters, and sets this property. Used by ArticlePage, AboutPage and ContactPage; HomePage and DocumentPage take their item as Content.
ItemPath string? null The source path of the item to find (ContentItem.Path, for example en/articles/my-article.md). A change of it, of ItemUrl, ItemSlug, the locale or the directory makes the page look the item up again.
ItemUrl string? null The public URL of the item to find (ContentItem.Url, for example articles/my-article), without a locale folder.
ItemSlug string? "contact" The slug of the item to find (ContentItem.Slug, for example my-article). Combine it with DirectoryName when slugs repeat across directories.
ItemUrlFormatter Func<ContentItem, string>? null Builds the links of the other parts of a series from the item. Passed on by ArticlePage to its series navigation; no other page reads it.
Locale string? "en" The locale of the content the page looks up (en by default): the item found with ItemPath, ItemUrl or ItemSlug, and the related items, must have it. Used by ArticlePage, AboutPage, ContactPage and ContentListPage. HomePage and DocumentPage show the item you pass as Content; HomePage lists the featured and recent items of this locale.
Query ContentQuery? null A complete content query that finds the item in place of ItemPath, ItemUrl, ItemSlug, Locale and DirectoryName; the first match is shown. Used by ArticlePage, AboutPage and ContactPage. Changing it alone does not make a displayed page load again.
SchemaTypes SchemaType[]? null The schema.org types written as the page's structured data, passed to SeoMetadataRenderer. When it is null, AboutPage uses AboutPage, ContactPage uses ContactPage, DocumentPage uses TechArticle and the other pages leave the choice to the renderer. DocumentPage also takes the first value as the article's microdata type.
GenerateMultipleSchemas bool true Whether to write more than one structured data type when it applies, for example the main type and a breadcrumb list. Used by ArticlePage, HomePage, AboutPage, ContactPage and DocumentPage.
WebsiteName string? null The site name that structured data and titles use, passed to SeoMetadataRenderer as SiteNameOverride. Used by every page component except LandingPage; ContentListPage passes it to its list.
SiteDescription string? null The site description, passed to SeoMetadataRenderer, which uses it as the feed description when the feed options set none. Without it the value of AddOsirionSeoMetadata or the Osirion:Seo section applies.
SiteLogoUrl string? null The address of the site logo for the organization's structured data (square, at least 112 by 112 pixels is recommended). Used by ArticlePage, HomePage, AboutPage, ContactPage and DocumentPage.
TwitterSite string? null The handle of the site for twitter:site, for example @contoso, passed to SeoMetadataRenderer. Without it the value of AddOsirionSeoMetadata or the Osirion:Seo section applies.
TwitterCreator string? null The handle of the author for twitter:creator, for example @author, passed to SeoMetadataRenderer. Without it the value of AddOsirionSeoMetadata or the Osirion:Seo section applies.
FacebookAppId string? null The Facebook app ID written as fb:app_id, passed to SeoMetadataRenderer. Without it the value of AddOsirionSeoMetadata or the Osirion:Seo section applies.
AllowAiDiscovery bool true Whether the crawler opt-in meta tags are written (true) or the opt-out tags (false), passed to SeoMetadataRenderer only when you set it. Without it the configured value of AddOsirionSeoMetadata or the Osirion:Seo section applies, which is true unless changed.
AllowAiTraining bool true Whether the training tags opt in (true) or out (false) of AI training, passed to SeoMetadataRenderer only when you set it. Without it the configured value applies. It has no effect when AllowAiDiscovery is false.
AllowSearchIndexing bool true Whether search engines may index the page, passed to SeoMetadataRenderer only when you set it. false writes noindex, nofollow as the robots tags. Without it the configured value applies.
EnableGeoOptimization bool true Whether the summary meta tags (entity-summary, content-type and the like) are written, when the item has a description, passed to SeoMetadataRenderer only when you set it. Without it the configured value applies.
EnableAeoOptimization bool true Whether the generated answer tags are allowed, passed to SeoMetadataRenderer only when you set it. Without it the configured value applies.
DefaultImageUrl string? null The image of the social cards for a page whose item has no featured image, passed to SeoMetadataRenderer. Without it the value of AddOsirionSeoMetadata or the Osirion:Seo section applies.
DefaultImageWidth int 1200 The width in pixels of DefaultImageUrl, passed to SeoMetadataRenderer. The default 1200 yields to the configured width.
DefaultImageHeight int 630 The height in pixels of DefaultImageUrl, passed to SeoMetadataRenderer. The default 630 yields to the configured height.
OrganizationName string? null The organization name for the structured data. Used by ArticlePage, HomePage, AboutPage, ContactPage and DocumentPage.
CustomBreadcrumbs List<ValueTuple<string, string>>? null Name and address pairs that replace the breadcrumb list in the page's structured data. They do not change the visible breadcrumbs. Used by ArticlePage and HomePage.
PrevPageUrl string? null The address of the previous page in a series, written as a rel="prev" link in the head. Used by ArticlePage, HomePage and DocumentPage.
NextPageUrl string? null The address of the next page in a series, written as a rel="next" link in the head. Used by ArticlePage, HomePage and DocumentPage.
AlternateLanguageUrls List<string>? null The addresses of the page's other language versions, written as hreflang links in the head. Used by every page component that writes head metadata except LandingPage.
LoadingText string "Loading article..." The text beside the spinner while an interactive render waits for the item (for HomePage, for its featured and recent items). A statically rendered response is sent once they have loaded, so it never contains it. Used by ArticlePage, HomePage, DocumentPage, AboutPage and ContactPage; LandingPage has its own.
ShowLoadingText bool true Whether the loading spinner shows LoadingText.
NotFoundTitle string "Page Not Found" The heading of the not-found state, shown when the page finds no item. Used by ArticlePage, HomePage, DocumentPage and AboutPage.
NotFoundText string "The page you're looking for doesn't exist or has been moved." The message of the not-found state. LandingPage has a parameter of its own.
ShowBackLink bool true Whether the not-found state has a button back, to BackLinkUrl with the text BackLinkText. It is not shown when the address is empty.
BackLinkUrl string "/" The address of the back link in the not-found state. It is written as given, so build it from values you control.
BackLinkText string "Go to Homepage" The text of the back link in the not-found state.
ShowHero bool false Whether the page's title and description appear in a HeroSection styled by the other Hero parameters. When it is off, ArticlePage shows no heading unless HeaderContent is set, while AboutPage and ContactPage show a plain OsirionPageHeading. AboutPage and ContactPage start with it off. DocumentPage never shows a hero.
UseHeroBackgroundImage bool false Whether the hero image is the hero's background instead of a picture beside the text. Used by ArticlePage, HomePage, AboutPage and ContactPage while ShowHero is on.
HasOverlay bool false Whether an overlay darkens the hero's background image so the text stays readable. It applies only with UseHeroBackgroundImage.
HeroImageUrl string? null The hero's image. ArticlePage falls back to the item's featured image when it is not set; AboutPage and ContactPage show no image without it; HomePage falls back to the item's featured image, as ArticlePage does.
HeroTheme ThemeMode ThemeMode.System The color mode of the hero: Light, Dark or System. Used by ArticlePage, HomePage, AboutPage and ContactPage.
HeroAlignment Alignment Alignment.Left How the hero's text is aligned, an Alignment value such as Left or Center. Used by ArticlePage, HomePage, AboutPage and ContactPage.
HeroImagePosition Alignment Alignment.Right Which side of the hero text the image sits on when it is not a background, an Alignment value (Left or Right). Used by ArticlePage, HomePage, AboutPage and ContactPage.
HeroVariant HeroVariant HeroVariant.Hero The hero's layout: Hero, Jumbotron or Minimal. Used by ArticlePage, HomePage, AboutPage and ContactPage.
ShowHeroButtons bool false Whether the hero of AboutPage and ContactPage shows its buttons. ArticlePage and HomePage ignore it and show a button whenever its text and address are both set.
HeroPrimaryButtonText string? null The text of the hero's primary button. The button needs HeroPrimaryButtonUrl too.
HeroPrimaryButtonUrl string? null The address of the hero's primary button. The button needs HeroPrimaryButtonText too.
HeroSecondaryButtonText string? null The text of the hero's secondary button. The button needs HeroSecondaryButtonUrl too.
HeroSecondaryButtonUrl string? null The address of the hero's secondary button. The button needs HeroSecondaryButtonText too.
HeroBackgroundPattern BackgroundPatternType? BackgroundPatternType.Grid The decorative pattern behind the hero text, or null for none. Used by ArticlePage, HomePage, AboutPage and ContactPage.
ShowBreadcrumbs bool true Whether to show the visible breadcrumbs: OsirionBreadcrumbs in ArticlePage, ContentBreadcrumbs in DocumentPage. The other pages show none.
ShowBreadcrumbHome bool true Whether the breadcrumbs start with a home link. Used by ArticlePage and DocumentPage.
BreadcrumbHomeText string "Home" The text of the breadcrumbs' home link. Used by ArticlePage and DocumentPage.
BreadcrumbHomeUrl string "/" The address of the breadcrumbs' home link. Used by ArticlePage and DocumentPage.
DirectoryName string? null The name of the directory the item must be in, as a filter of the query that finds it. Used by ArticlePage, AboutPage and ContactPage.
DirectoryUrlFormatter Func<DirectoryItem, string>? null Builds the address of a breadcrumb that stands for a directory. Used by DocumentPage; the other pages do not read it.
ShowCategoriesSidebar bool true Whether the sidebar of ArticlePage lists the item's categories. The section appears only when the item has categories.
CategoriesSectionTitle string "Categories" The heading of the category list: in the sidebar of ArticlePage, and in the browse section of HomePage.
CategoryUrlFormatter Func<string, string>? null Builds a category link from the category name. Used by ArticlePage (sidebar) and HomePage (browse section); without it the link is /category/{slug}.
ShowTagsSidebar bool true Whether the sidebar of ArticlePage lists the item's tags. The section appears only when the item has tags.
TagsSectionTitle string "Tags" The heading of the tag list: in the sidebar of ArticlePage, and in the browse section of HomePage.
TagUrlFormatter Func<string, string>? null Builds a tag link from the tag name. Used by ArticlePage (sidebar) and HomePage (browse section); without it the link is /tag/{slug}.
Theme ThemeMode ThemeMode.System The component's color mode. Light or Dark writes it to data-theme (data-bs-theme under Bootstrap) on the root element; System writes nothing.
Class string? null Extra CSS classes for the component's root element.
Style string? null An inline style for the component's root element.

Behavior

  • Rendering. The page renders on the server and needs no script; it does not use streaming rendering. The form posts as an ordinary HTML form under static SSR, named by FormId. While an interactive render waits for the item it shows a spinner with LoadingText.
  • Head. With a content item, the page writes a SeoMetadataRenderer for it, with ContactPage structured data unless SchemaTypes says otherwise. Without one, it sets the page title to Title and, when Description is set, a meta description. With an item, SiteDescription, TwitterSite, TwitterCreator, FacebookAppId, DefaultImageUrl, DefaultImageWidth and DefaultImageHeight reach the renderer when set, and so do AllowAiDiscovery, AllowAiTraining, AllowSearchIndexing, EnableGeoOptimization and EnableAeoOptimization when you set them: a switch you leave out keeps the value of AddOsirionSeoMetadata or the Osirion:Seo section.
  • Heading. The title and description are an OsirionPageHeading, or a HeroSection when ShowHero is on. The item's body, when it has one, follows, without its own leading h1.
  • Form. FormContent replaces the built-in form. Otherwise the page renders an OsirionContactForm with FormId, FormTitle, FormDescription, UseBuiltInEmailService and OnSubmit, and shows the contact details beside it only when ContactInfo is set.
  • Not found. A missing content item is not an error: the page renders from Title and Description and the response keeps status 200.
  • Attributes. Class, Style and unmatched attributes go to the root element, and so does Theme as data-theme (data-bs-theme under Bootstrap) when it is Light or Dark.

Styling

The root element has the class osirion-contact-page. The introduction is in osirion-contact-page-body, the form in osirion-contact-page-form and the child content in osirion-contact-page-more; all three are centered at the width --osirion-container-lg (960 pixels when unset), the width of OsirionPageHeading.

Edit this page

Cookie Consent

We use cookies to improve your experience on our website. By continuing to browse, you agree to our use of cookies.

An unhandled error has occurred. Reload 🗙