title: “Gopls: Inlay hints”

Inlay hints are helpful annotations that the editor can optionally display in-line in the source code, such as the names of parameters in a function call. This document describes the inlay hints available from gopls.

assignVariableTypes

"assignVariableTypes" controls inlay hints for variable types in assign statements:

	i« int», j« int» := 0, len(r)-1

Disabled by default. Enable it by setting "hints": {"assignVariableTypes": true}.

compositeLiteralFields

"compositeLiteralFields" inlay hints for composite literal field names:

	Point2D{«X: »1, «Y: »2}

	Outer{«Embedded.»Field: 0}

Disabled by default. Enable it by setting "hints": {"compositeLiteralFields": true}.

compositeLiteralTypes

"compositeLiteralTypes" controls inlay hints for composite literal types:

	for _, c := range []struct {
		in, want string
	}{
		«struct{ in string; want string }»{"Hello, world", "dlrow ,olleH"},
	}

Disabled by default. Enable it by setting "hints": {"compositeLiteralTypes": true}.

constantValues

"constantValues" controls inlay hints for constant values:

	const (
		KindNone   Kind = iota« = 0»
		KindPrint«  = 1»
		KindPrintf« = 2»
		KindErrorf« = 3»
	)

Disabled by default. Enable it by setting "hints": {"constantValues": true}.

functionTypeParameters

"functionTypeParameters" inlay hints for implicit type parameters on generic functions:

	myFoo«[int, string]»(1, "hello")

Disabled by default. Enable it by setting "hints": {"functionTypeParameters": true}.

ignoredError

"ignoredError" inlay hints for implicitly discarded errors:

	f.Close()« // ignore error»

This check inserts an // ignore error hint following any statement that is a function call whose error result is implicitly ignored.

To suppress the hint, write an actual comment containing “ignore error” following the call statement, or explicitly assign the result to a blank variable. A handful of common functions such as fmt.Println are excluded from the check.

Disabled by default. Enable it by setting "hints": {"ignoredError": true}.

parameterNames

"parameterNames" controls inlay hints for parameter names:

	parseInt(« str: » "123", « radix: » 8)

Disabled by default. Enable it by setting "hints": {"parameterNames": true}.

rangeVariableTypes

"rangeVariableTypes" controls inlay hints for variable types in range statements:

	for k« int», v« string» := range []string{} {
		fmt.Println(k, v)
	}

Disabled by default. Enable it by setting "hints": {"rangeVariableTypes": true}.