Skip to content

Document Fallback.ToDefaultLanguage in IPublishedContent properties#8166

Merged
sofietoft merged 1 commit into
mainfrom
docs/fallback-default-language
Jun 17, 2026
Merged

Document Fallback.ToDefaultLanguage in IPublishedContent properties#8166
sofietoft merged 1 commit into
mainfrom
docs/fallback-default-language

Conversation

@ronaldbarendse

Copy link
Copy Markdown
Contributor

Description

The Fallbacks section of the IPublishedContent properties documentation was missing the Fallback.ToDefaultLanguage option.

This fallback policy (Fallback.DefaultLanguage enum value / Fallback.ToDefaultLanguage helper) was added in umbraco/Umbraco-CMS#13814 and shipped in Umbraco 11.3.0. It falls back to the value from the site's default language without requiring a specific culture to be specified.

Changes

Added a new ### Fallback to Default Language subsection to the Fallbacks section in all currently supported versions:

  • 13/umbraco-cms/reference/querying/ipublishedcontent/properties.md
  • 16/umbraco-cms/reference/querying/ipublishedcontent/properties.md
  • 17/umbraco-cms/develop-with-umbraco/templating-and-rendering/querying/ipublishedcontent/properties.md
  • 18/umbraco-cms/develop-with-umbraco/templating-and-rendering/querying/ipublishedcontent/properties.md

The API naming was verified against the Fallback struct in the CMS source.

Copilot AI review requested due to automatic review settings June 16, 2026 13:38
@github-actions

Copy link
Copy Markdown

Thanks for opening this PR! 🎉

Quick question: Does this PR include any AI-generated content?

AI tools are absolutely welcome here! We only ask that you follow our AI contribution guidelines to help keep the documentation consistent and trustworthy.

Drop a quick comment to let us know!

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Documents the Fallback.ToDefaultLanguage option in the IPublishedContent properties “Fallbacks” section, aligning the docs with the fallback policy introduced in the CMS and ensuring readers know how to use it across currently supported Umbraco versions.

Changes:

  • Added a new “Fallback to Default Language” subsection describing the behavior and intent.
  • Added a Razor example showing fallback: Fallback.ToDefaultLanguage usage.
  • Applied the same documentation update consistently across v13, v16, v17, and v18 docs.

Reviewed changes

Copilot reviewed 4 out of 4 changed files in this pull request and generated no comments.

File Description
18/umbraco-cms/develop-with-umbraco/templating-and-rendering/querying/ipublishedcontent/properties.md Adds a “Fallback to Default Language” subsection with explanation and example in the Fallbacks section.
17/umbraco-cms/develop-with-umbraco/templating-and-rendering/querying/ipublishedcontent/properties.md Same documentation addition for v17.
16/umbraco-cms/reference/querying/ipublishedcontent/properties.md Same documentation addition for v16.
13/umbraco-cms/reference/querying/ipublishedcontent/properties.md Same documentation addition for v13.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

@sofietoft sofietoft merged commit 62861aa into main Jun 17, 2026
12 checks passed
@ronaldbarendse ronaldbarendse deleted the docs/fallback-default-language branch June 17, 2026 10:55
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants