Skip to content

03 Configuration

David Sheiles edited this page Nov 27, 2025 · 2 revisions

Configuration Guide

This guide explains how to configure Meta Momentum Data Types in your Umbraco backoffice.

Creating a Data Type

Step 1: Navigate to Data Types

  1. Open the Umbraco backoffice
  2. Go to SettingsData Types
  3. Click CreateNew Data Type
  4. Give it a name (e.g., "Meta Momentum")
  5. Select Meta Momentum as the Property Editor

Step 2: Configure Settings

Meta Momentum provides several configuration options to customize the editor experience.

Configuration Options

Search Engine Settings

Title / Description fields for search

Type: Toggle
Default: On

Enable this to allow content editors to customize the title and description meta tags for search engines. When disabled, the editor cannot modify these fields, and fallback values are used.


Search Preview

Type: Toggle
Default: On

Shows a visual preview of how the page will appear in Google search results, including:

  • Site URL and breadcrumb
  • Title tag (with width-based character limits)
  • Meta description (with width-based character limits)

Fallback Title Fields

Type: Text (comma-separated aliases)
Example: pageTitle,heading,name

Specifies a prioritized list of property aliases to use when the title field is empty. The system checks each alias in order until it finds a value.

How it Works:

  1. Checks custom title field
  2. Falls back to first alias (e.g., pageTitle)
  3. If empty, tries next alias (e.g., heading)
  4. Finally uses the page name (The Name of the Content Node) if all else fails

Supported Field Types:

  • String
  • Textstring
  • Textarea
  • Rich Text Editor (HTML is stripped)

Limitations: Does not support complex data types like Grid or Nested Content.


Fallback Description Fields

Type: Text (comma-separated aliases)
Example: pageDescription,introduction,summary

Similar to Fallback Title Fields, but for the meta description. If no fallback is found, the description remains empty.

Limitations: Does not support complex data types like Grid or Nested Content.

Fallback Image Fields

Type: Text (comma-separated aliases)
Example: socialImage,heroImage,featuredImage

Specifies which media picker or upload fields to use for social share images.

Supported Field Types:

  • Media Picker (v2)
  • Media Picker (v3)
  • Upload field (Not-reccomended)

Upload Field Limitation: When falling back to an upload field, content must be saved and published twice:

  1. First save uploads the image
  2. Second save properly stores it in the social meta fields

Social Share Settings

Social Share Fields

Type: Toggle
Default: On

Enable this to allow content editors to customize title and description specifically for social media shares. When disabled, social shares use the same values as search meta (with fallbacks).


Facebook Share Preview

Type: Toggle
Default: On

Shows a preview of how the page appears when shared on Facebook, including:

  • Site name
  • Share title
  • Share description
  • Share image (281x540px cropped preview)

Twitter Share Preview

Type: Toggle
Default: On

Shows a preview of Twitter/X card, including:

  • Share title
  • Share description
  • Share image (220x438px cropped preview)
  • Site URL

LinkedIn Share Preview

Type: Toggle
Default: On

Shows a preview of LinkedIn share card, including:

  • Share title
  • Site URL
  • Share image (263x520px cropped preview)

Advanced Settings

Site Name

Type: Text
Example: Acme Inc.

The site name used in Open Graph meta tags (og:site_name). This appears in social shares as the brand/website name.

Migrating from V2.x: This replaces the Site Name setting from appsettings.json.


Twitter Name

Type: Text
Example: @digitalmomentum

Your Twitter/X handle (including the @). Used in Twitter Card meta tags to attribute the content to your account.

Migrating from V2.x: This replaces the Twitter Name setting from appsettings.json.


Using the Data Type

Step 3: Add to Document Types

  1. Go to SettingsDocument Types
  2. Open the Document Type you want to add SEO to
  3. Add a new property:
    • Name: SEO & Social
    • Alias: metaMomentum (or your preferred alias)
    • Data Type: Select your Meta Momentum data type

Recommended: Create a Composition with Meta Momentum and apply it to all content Document Types.

Example Composition Setup

  1. Create a Document Type called "SEO Composition"
  2. Add the Meta Momentum property
  3. Set as Element Type (composition)
  4. Add this composition to all your content Document Types

This ensures consistent SEO management across your entire site.

Next Steps