JetBrains Rider 2024.3 Help

Inlay hints

Inlay hints are configurable editor adornments that improve the readability of your code.

Push-to-Hint mode

Inlay hints can be helpful, but on the other hand, they take editor space and may seem redundant in some cases. To view inlay hints on demand, you can use the Push-to-Hint mode. It lets you keep the hints hidden and only view them when needed.

Show inlay hints on a key press

  1. Make sure that the application focus is in the editor.

  2. Press the Ctrl key twice and hold it after the second press. Inlay hints will be shown as long as you are holding it.

  3. If you want to continue showing inlay hints after releasing the Ctrl key, click the corresponding adornment in the top right corner of the editor:

    JetBrains Rider: Pin inlay hints for the current file

    To stop showing inlay hints, click the Push-to-Hint adornment once again.

If you want inlay hints to be always shown or hidden in all editor tabs, use the Default visibility selector on the Editor | Inlay Hints page of JetBrains Rider settings Ctrl+Alt+S. Whatever you choose for the default visibility, you can override it for specific kind of hints on the corresponding settings pages under Editor | Inlay Hints.

If the press-and-hold or double-press of the Ctrl key is already bound to some other actions in your OS or other applications , JetBrains Rider will override those mappings even if you don't use Push-to-Hint. To avoid that, clear the Reserve double-press-and-hold of the Ctrl key for Push-To-Hint checkbox on the Editor | Inlay Hints page of JetBrains Rider settings Ctrl+Alt+S.

Parameter name hints

As an alternative to writing named arguments in method calls, you can make use of JetBrains Rider's parameter name hints — editor adornments that show parameter names next to the corresponding arguments at method calls.

Consider the following method call:

AddCheckbox(true, true, "AutoFill", null);

When you read this code, you have to stop and study the method signature to understand what happens here (you can do it either with the parameter information tooltip or by navigating to method declaration). With parameter name hints, the same call becomes much clearer:

JetBrains Rider: inline parameter name hints help understand arguments in a method call

The idea of the parameter name hints is to show parameter names for arguments whose intention may not be clear, but at the same time not to clutter the editor with hints where the argument purpose is obvious, and of course if there are named arguments in the call. To achieve this, JetBrains Rider applies a number of configurable heuristics.

Type name hints

Type name hints help you understand types variables and expressions have in different contexts. For example:

  • anonymous types,

    JetBrains Rider: Inlay hints. long type name
  • parameters of lambda expressions,

    JetBrains Rider: Inlay hints. lambda expression parameter
  • return types of methods in a call chain,

    JetBrains Rider: Inlay hints return type in call chain

and in many other cases.

If necessary, you can configure type name hints for each specific case.

Type conversion hints

Type conversion hints show implicit type conversions in your code.

In the example below, converting from Vector3D to Vector2D silently loses data (the Z value) and the hint helps us see where this happens.

JetBrains Rider: Type conversion hints

If you see that a type conversion hint for a specific conversion is not very helpful, you can disable conversion hints for all conversions involving those specific types. To do so, place the caret next to the assignment operator, press Alt+Enter and choose Configure Inlay Hints | Type Conversion Hints | Hide for.... The change will be saved, and you will be able to review or revert it later on the Editor | Inlay Hints | C# | Type Conversion Hints page of JetBrains Rider settings Ctrl+Alt+S.

Code analysis hints

You can display missing returns in functions and missing breaks in switch statements using inlay hints. This lets you immediately understand what exactly is missing:

JetBrains Rider Inlay hints: missing return

You can use inlay hints to see places where resource variables are disposed:

JetBrains Rider Inlay hints: disposed resource variable

If you are using the [MustDisposeResourceAttribute] from JetBrains.Annotations to enforce resource disposal in the calling code, JetBrains Rider helps you visually identify constructors and factory methods that return a disposable resource:

JetBrains Rider Inlay hints: MustDisposeResourceAttribute

To configure visibility of these hints, use the corresponding selectors on the Editor | Inlay Hints | C# | Other page of JetBrains Rider settings Ctrl+Alt+S.

Inlay hints for C# interceptors

Inlay hints will help you spot intercepted calls, with the additional ability to navigate to the interceptor method with Alt+Enter or with Ctrl+click on the hint icon:

JetBrains Rider: Inlay hint and navigation action for an intercepted method

The [InterceptsLocation] annotation on the interceptor method has a hint that allows you to navigate to the intercepted call:

JetBrains Rider: Inlay hint and navigation action for an intercepted method

To configure visibility of these hints, use the corresponding selectors on the Editor | Inlay Hints | C# | Interceptor Hints page of JetBrains Rider settings Ctrl+Alt+S.

Inlay hints for unnamed constructs

You can see tuple component names as inlay hints when those names are not apparent from the component expression:

JetBrains Rider: Inlay hints for tuple component names

Inlay hints can greatly improve the readability of a deconstruction pattern by showing the declared names of its components:

JetBrains Rider: Inlay hints for deconstruction pattern component names

When a method returns more variables than needed, and some are discarded with _, inlay hints can help you see what is discarded. By default, hints for discards work with push-to-hint:

JetBrains Rider: Inlay hints for discard names

To configure visibility of these hints, use the corresponding selectors on the Editor | Inlay Hints | C# | Other page of JetBrains Rider settings Ctrl+Alt+S.

'#pragma warning' hints

#pragma warning directives allow you to disable and restore specific warnings by their ID. It is hard to remember what each ID means, therefore JetBrains Rider can add inlay hints with warning descriptions. Note that this kind of hints only work with compiler warnings, whose IDs start with CS.

JetBrains Rider: Inlay hints for '#pragma warning' directives

To configure visibility of these hints, use the corresponding selectors on the Editor | Inlay Hints | C# | Other page of JetBrains Rider settings Ctrl+Alt+S.

Configure inlay hints

You can toggle and configure inlay hints on the corresponding settings pages under the Editor | Inlay Hints page of JetBrains Rider settings Ctrl+Alt+S.

If you do not use inlay hints, you can disable them by clearing the Enable Inlay Hints in .NET languages checkbox on the Editor | Inlay Hints | General settings page. JetBrains Rider will stop calculating hints thus saving some resources.

However, if you want to see only a few specific kinds of hints, you can set the Default visibility selector on that page to Never Show and then override this with visibility selectors for the desired types of hints.

For parameter name hints, you can additionally hide hints in methods matching specific patterns. To do so, add these patterns at the bottom of the Environment | Inlay Hints | [language] | Parameter Name Hints page of JetBrains Rider settings Ctrl+Alt+S.

Here are some examples of patterns:

  • System.Math.* matches all methods whose FQN starts with System.Math

  • System.Math.*(*, *) matches all methods from System.Math namespace with two parameters

  • (*info) matches all single-parameter methods where the parameter name ends with info

  • (key, value) matches all methods with parameters key and value

  • Put(key, value) matches all Put methods with parameters key and value

When your caret is at a code item that has an inlay hint, you can press Alt+Enter, choose Configure Inlay Name Hints, or instead, right-click a parameter hint, and then pick one of the commands, which allow you to:

  • hide parameter hints for all calls of the method, or type name hints that apply for the current item (if you want to show hints that you disabled, you can find the corresponding item or exception pattern in the options page and remove it),

  • change visibility of this kind of hints,

  • disable inlay hints altogether (you can enable them later in the options page),

  • or open the options page for detailed configuration.

JetBrains Rider: configuring parameter name hints from the Alt+Enter menu

If you right-click a paramter name, type name, or a type name hint, you can also navigate to the declaration of the corresponding type or parameter declaration:

JetBrains Rider: configuring parameter name hints from the Alt+Enter menu

You can configure the color of inlay hints on the Editor | Color Scheme | Language Defaults settings page  Ctrl+Alt+S — choose the Inline parameter hints | Default item.

Last modified: 19 November 2024