# Release Candidate Guide

The RC can be used to test your website and projects against the next major version of Umbraco CMS.

This article contains all the resources needed for you to start testing.

* [How to Test the Release Candidate](#test-the-release-candidate)
* [What to Focus on When Testing](#what-to-focus-on-when-testing)
* [New and Updated Documentation](#new-and-updated-documentation)

{% hint style="info" %}
This document will be updated and expanded as more and more documentation are added throughout the release candidate phase.
{% endhint %}

## Test the Release Candidate

Ensure you meet the prerequisites and move on to the installation steps outlined below.

### Prerequisites

* The latest [.NET SDK 10.0](https://dotnet.microsoft.com/en-us/download/dotnet/10.0).

### Install the Release Candidate

The [release candidate is available on NuGet](https://www.nuget.org/packages/Umbraco.Templates/17.0.0-beta).

1. Install the Umbraco dotnet template for the Release Candidate.

```cmd
dotnet new install Umbraco.Templates::17.0.0-beta
```

2. Create a new Umbraco project.

```cmd
dotnet new umbraco -n MyCustomUmbracoProject
```

3. Navigate to the newly created folder.

```cmd
cd MyCustomUmbracoProject
```

4. Build and run the project.

```cmd
dotnet build
dotnet run
```

This will boot the project, and write the log to the console. The website is now running on your local machine and will be available on the ports written in the console.

{% hint style="info" %}
Alternatively, you can install and run the Umbraco project using your favorite IDE (Integrated Development Environment).
{% endhint %}

## What to focus on when testing

Read the [Release Candidate blog post](https://umbraco.com/blog/umbraco-17-beta-is-out/) to learn more about notable features and changes added to the upcoming version.

The blog post will mention if there are any specific features or workflows that the Umbraco HQ team needs feedback on.

## New and updated documentation

Here is a list of all the new or updated articles in this version.

* [Version Specific Updates: Breaking Changes](https://docs.umbraco.com/umbraco-cms/fundamentals/setup/upgrading/version-specific#umbraco-17)
* [Date Time Property Editor](https://docs.umbraco.com/umbraco-cms/fundamentals/backoffice/property-editors/built-in-umbraco-property-editors/date-time-editor)
* [`UnattendedTelemetryLevel` Setting](https://docs.umbraco.com/umbraco-cms/fundamentals/setup/install/install-umbraco-with-templates) and [`UnattendedTelemetryLevel` in Unattended Install](https://docs.umbraco.com/umbraco-cms/fundamentals/setup/install/unattended-install)
* [`UnattendedTelemetryLevel` in the Configuration article](https://docs.umbraco.com/umbraco-cms/reference/configuration/unattendedsettings#unattended-telemetry-level)
* [`GenerateVirtualProperties` option to disable virtual properties](https://docs.umbraco.com/umbraco-cms/reference/configuration/modelsbuildersettings#generate-virtual-properties)
* [Removed the warning on `Microsoft.EntityFrameworkCore.Design` dependency conflicts](https://docs.umbraco.com/umbraco-cms/tutorials/getting-started-with-entity-framework-core)
* [Kestrel `MaxRequestLength` updated to 50MB](https://docs.umbraco.com/umbraco-cms/reference/configuration/maximumuploadsizesettings#using-kestrel)
* [Backoffice Signs](https://docs.umbraco.com/umbraco-cms/customizing/signs)
* [Flag Providers](https://docs.umbraco.com/umbraco-cms/extending/flag-providers)
* [Added `ComposeAfter` attribute to the composer used in the Examine sample](https://docs.umbraco.com/umbraco-cms/reference/searching/examine/indexing#creating-a-configureoptions-class)
* [Displaying the MiniProfiler](https://docs.umbraco.com/umbraco-cms/fundamentals/code/debugging#displaying-the-miniprofiler)
* [Load Balancing the Backoffice](https://docs.umbraco.com/umbraco-cms/fundamentals/setup/server-setup/load-balancing/load-balancing-backoffice)
* [SignalR in a Backoffice Load Balanced Environment](https://docs.umbraco.com/umbraco-cms/fundamentals/setup/server-setup/load-balancing/signalr-in-backoffice-load-balanced-environment)
* [Distributed jobs settings](https://docs.umbraco.com/umbraco-cms/reference/configuration/distributedjobssettings)
* [Background jobs when load balancing the backoffice](https://docs.umbraco.com/umbraco-cms/reference/scheduling#background-jobs-when-load-balancing-the-backoffice)
* [Property Editor Data Source](https://docs.umbraco.com/umbraco-cms/customizing/property-editors/composition/property-editor-data-source)
* [Picker Data Source Type](https://docs.umbraco.com/umbraco-cms/customizing/property-editors/property-editor-data-source-types/picker)
* [Collection Data Source](https://docs.umbraco.com/umbraco-cms/customizing/property-editors/property-editor-data-source-types/picker/picker-collection-data-source)
* [Tree Data Source](https://docs.umbraco.com/umbraco-cms/customizing/property-editors/property-editor-data-source-types/picker/picker-tree-data-source)
* [Entity Data Picker](https://docs.umbraco.com/umbraco-cms/fundamentals/backoffice/property-editors/built-in-umbraco-property-editors/entity-data-picker)
* [Kinds](https://docs.umbraco.com/umbraco-cms/customizing/extending-overview/extension-types/workspaces/workspace-action-menu-items#kinds)
* [Repositories](https://docs.umbraco.com/umbraco-cms/customizing/foundation/repositories)
* [Collection Repository](https://docs.umbraco.com/umbraco-cms/customizing/foundation/repositories/repository-types/collection-repository)
* [Detail Repository](https://docs.umbraco.com/umbraco-cms/customizing/foundation/repositories/repository-types/detail-repository)
* [Item Repository](https://docs.umbraco.com/umbraco-cms/customizing/foundation/repositories/repository-types/item-repository)
* [Tree Repository](https://docs.umbraco.com/umbraco-cms/broken-reference)
* [Temporary File Storage](https://docs.umbraco.com/umbraco-cms/fundamentals/setup/server-setup/load-balancing/load-balancing-backoffice#temporary-file-storage)
* [Backoffice token cookie settings](https://docs.umbraco.com/umbraco-cms/reference/configuration/securitysettings#backoffice-token-cookie-settings)

### Removed articles

* Editor Model Notifications
* Content Dashboard Settings

### Updated articles

* [Additional preview environments support](https://docs.umbraco.com/umbraco-cms/reference/content-delivery-api/additional-preview-environments-support)
* [Outbound Pipeline](https://docs.umbraco.com/umbraco-cms/reference/routing/request-pipeline/outbound-pipeline)
* [Property Actions](https://docs.umbraco.com/umbraco-cms/customizing/property-editors/property-actions)
* [Confirm Dialog](https://github.com/umbraco/UmbracoDocs/blob/main/17/umbraco-cms/customizing/extending-overview/extension-types/modals/confirm-dialog.md)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.umbraco.com/umbraco-cms/release-candidate-guide.md?ask=<question>
```

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.
