Docs
Display Options

Display Options

Options that are used to configure how the output is structured and displayed.

—hidePageHeader

💡
Do not print page header.

Accepts a boolean value. Defaults to false.

typedoc.json
{
  "hidePageHeader": false
}

—hideBreadcrumbs

💡
Do not print breadcrumbs.

Accepts a boolean value. Defaults to false.

typedoc.json
{
  "hideBreadcrumbs": false
}

—hidePageTitle

💡
Do not print page title.

Accepts a boolean value. Defaults to false.

typedoc.json
{
  "hidePageTitle": false
}

—hideGroupHeadings

💡

Excludes grouping by kind so all members are rendered and sorted at the same level.

Accepts a boolean value. Defaults to false.

By default members are grouped by kind (eg Classes, Functions etc).

This creates a flat structure where all members are displayed at the same heading level.

typedoc.json
{
  "hideGroupHeadings": false
}

—useCodeBlocks

💡
Wraps signatures and declarations in code blocks.

Accepts a boolean value. Defaults to false.

This option can be used to improve readability and aesthetics when defining signatures and declarations.

Please note that when this option is set to true it is not possible to link to other references.

As a work around the @link tag can be be used to manually reference types.

typedoc.json
{
  "useCodeBlocks": false
}

—expandObjects

💡
Expand objects inside declarations.

Accepts a boolean value. Defaults to false.

By default objects inside declarations are collapsed to preserve space and improve readability.

This option should be set when a full object representation is preferred.

typedoc.json
{
  "expandObjects": false
}

—expandParameters

💡

Expand parameters in signature parentheses to display type information.

Accepts a boolean value. Defaults to false.

By default parameters in signature definitions only display the parameter name so the output is more concise.

This option should be set when a full type representation is preferred.

typedoc.json
{
  "expandParameters": false
}

—blockTagsPreserveOrder

💡

Specifies comment block tags that should preserve their position in relation to the comment summary.

Accepts an array of string values.

By default block tags (such as @example, @remarks, @deprecated) are rendered after “Parameters”, “Returns” and “Type declaration” sections for signatures and declarations.

The rationale is that comment block tags often contain more detailed, supplementary information and are typically secondary to understanding the primary use of the symbol,

Use this option to preserve the position of the tag content with the comment summary.

typedoc.json
{
  "blockTagsPreserveOrder": ["@example", "@deprecated"]
}

—indexFormat

💡
Sets the format of index items.

Accepts one of "list" | "table" | "htmlTable". Defaults to "list".

This option renders index items either as a simple unordered list or in a table.

When table style is selected the following will be the behaviour:

  • For a members index, a description column will be added with key table - the first paragraph of the comment summary, or key htmlTable - the entire comment contents.
  • For a packages index, (when --entryPointStrategy equals packages), the package.json description will be displayed with an additional “Version” column (when --includeVersion equals true).
  • For a documents index a description column will be added to the table printing the "description" frontmatter variable.
typedoc.json
{
  "indexFormat": "list"
}

—parametersFormat

💡

Sets the format of parameter and type parameter groups.

Accepts one of "list" | "table" | "htmlTable". Defaults to "list".

This option specifies the output format for parameters and type parameters of functions and class methods:

  • “list”: parameters are output as bullet points in a linear list, suitable for more detailed comments.
  • “table”: parameters are output within a Markdown table, condensed into a single paragraph.
  • “htmlTable”: parameters are output in an HTML table, enabling block elements to render in table cells.
typedoc.json
{
  "parametersFormat": "list"
}

—interfacePropertiesFormat

💡
Sets the format of property groups for interfaces.

Accepts one of "list" | "table" | "htmlTable". Defaults to "list".

This option specifies the output format for interface properties:

  • “list”: properties are output in linear blocks with headings, suitable for more detailed comments.
  • “table”: properties are output within a Markdown table, condensed into a single paragraph.
  • “htmlTable”: properties are output in an HTML table, enabling block elements to render in tabular format.
typedoc.json
{
  "interfacePropertiesFormat": "list"
}

—classPropertiesFormat

💡
Sets the format of property groups for classes.

Accepts one of "list" | "table" | "htmlTable". Defaults to "list".

This option specifies the output format for class properties:

  • “list”: properties are output in linear blocks with headings, suitable for more detailed comments.
  • “table”: properties are output within a Markdown table, condensed into a single paragraph.
  • “htmlTable”: properties are output in an HTML table, enabling block elements to render in tabular format.
typedoc.json
{
  "classPropertiesFormat": "list"
}

—enumMembersFormat

💡
Sets the format of enumeration members.

Accepts one of "list" | "table" | "htmlTable". Defaults to "list".

This option specifies the output format for enumeration members:

  • “list”: members are output in linear blocks with headings, suitable for more detailed comments.
  • “table”: members are output within a Markdown table, condensed into a single paragraph.
  • “htmlTable”: members are output in an HTML table, enabling block elements to render in tabular format.
typedoc.json
{
  "enumMembersFormat": "list"
}

—typeDeclarationFormat

💡

Sets the format of style for type declaration members.

Accepts one of "list" | "table" | "htmlTable". Defaults to "list".

This option specifies the output format for type declaration of variables and type aliases.

  • “list”: declarations are output in linear blocks with headings, suitable for more detailed comments.
  • “table”: declarations are output within a Markdown table, condensed into a single paragraph.
  • “htmlTable”: declarations are output in an HTML table, enabling block elements to render in tabular format.
typedoc.json
{
  "typeDeclarationFormat": "list"
}

—propertyMembersFormat

💡

Sets the format of style for property members for interfaces and classes.

Accepts one of "list" | "table" | "htmlTable". Defaults to "list".

This option will handle the formatting of object literals assigned as properties in classes or interfaces.

Note this options will only take effect when the property declaration is rendered in a list format.

  • “list”: members are output in linear blocks with headings, suitable for more detailed comments.
  • “table”: members are output within a Markdown table, condensed into a single paragraph.
  • “htmlTable”: members are output in an HTML table, enabling block elements to render in tabular format.
typedoc.json
{
  "propertyMembersFormat": "list"
}

—tableColumnSettings

💡

Control how table columns are configured and displayed.

By default, all available data for symbols are displayed in table columns which can result in several columns in certain use-cases.

This option allows you to control the visibility of columns, prioritizing readability over displaying complete data. In addition you can control the alignment of the header text.

typedoc.json
{
  "tableColumnSettings": {
    "hideDefaults": false,
    "hideInherited": false,
    "hideModifiers": false,
    "hideOverrides": false,
    "hideSources": false,
    "hideValues": false,
    "leftAlignHeaders": false
  }
}