Class MaterialIcon

  • MaterialIcon is an object that supports all Google Font Icons and is available for Google Workspace add-ons and Google Chat apps.

  • You can set the name of the icon using setName(), which is a required parameter.

  • The appearance of the icon can be customized using methods like setFill(), setGrade(), and setWeight().

  • setFill() determines if the icon is solid, while setGrade() and setWeight() affect the thickness of the icon.

MaterialIcon

An object that supports all Google Font Icons.

Available for Google Workspace add-ons and Google Chat apps.

constmaterialIcon=CardService.newMaterialIcon()
.setName('search')
.setFill(true)
.setWeight(400)
.setGrade(0);

Methods

MethodReturn typeBrief description
setFill(fill) MaterialIcon Whether the icon renders as filled.
setGrade(grade) MaterialIcon Weight and grade affect a symbol’s thickness.
setName(name) MaterialIcon Sets the name of the icon.
setWeight(weight) MaterialIcon The stroke weight of the icon.

Detailed documentation

setFill(fill)

Whether the icon renders as filled. Default value is false.

To preview different icon settings, go to Google Font Icons and adjust the settings under Customize.

constmaterialIcon=
CardService.newMaterialIcon().setName('search').setFill(true);

Parameters

NameTypeDescription
fillBooleanWhether the icon is filled.

Return

MaterialIcon — This object, for chaining.


setGrade(grade)

Weight and grade affect a symbol’s thickness. Adjustments to grade are more granular than adjustments to weight and have a small impact on the size of the symbol. Choose from {-25, 0, 200}. If absent, default value is 0. If any other value is specified, the default value is used.

To preview different icon settings, go to Google Font Icons and adjust the settings under Customize.

constmaterialIcon=
CardService.newMaterialIcon().setName('search').setGrade(200);

Parameters

NameTypeDescription
gradeIntegerThe icon's grade.

Return

MaterialIcon — This object, for chaining.


setName(name)

Sets the name of the icon. Required.

The icon name defined in Google Font Icon, For example, check_box.

Any invalid names are abandoned and replaced with an empty string and results in the icon failing to render.

constmaterialIcon=CardService.newMaterialIcon().setName('search');

Parameters

NameTypeDescription
nameStringThe name of the icon.

Return

MaterialIcon — This object, for chaining.


setWeight(weight)

The stroke weight of the icon. Choose from {100, 200, 300, 400, 500, 600, 700}. If absent, default value is 400. If any other value is specified, the default value is used.

To preview different icon settings, go to Google Font Icons and adjust the settings under Customize.

constmaterialIcon=
CardService.newMaterialIcon().setName('search').setWeight(700);

Parameters

NameTypeDescription
weightIntegerThe stroke weight of the icon.

Return

MaterialIcon — This object, for chaining.

Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.

Last updated 2026年04月13日 UTC.