Skip to main content

5.3 Style Settings

The look of the materials list is a single site-wide setting: every course, lesson, topic, and quiz renders its list the same way. Configure it at Settings > Learndash Materials on the Settings tab.

The Learndash Materials settings page with the Basic style loaded: list type Link, icon position, text colours, font family and size

Start from a preset

The Style template dropdown at the top offers three presets. Choose one and click Load to fill the fields below with the preset's values, then adjust anything you like and click Save Changes.

PresetList typeLook
BasicLinkA plain vertical list of grey links that darken on hover. The default until you save something else.
Button 1ButtonOutlined pill buttons: grey text and border on a transparent fill; the fill turns grey and the text white on hover.
Button 2ButtonFilled pill buttons: white text on a grey fill that darkens on hover.
tip

Load only fills the fields; nothing is applied until you click Save Changes. And it only sets the fields a preset defines: the Basic preset does not touch the button colours, so if you switch from a button preset back to Basic and later flip List type to Button by hand, you may get button colours left over from before. When you want buttons, load a button preset.

The settings

SettingOptionsWhat it controls
List typeLink, ButtonPlain links, or each material as a full-width pill button. Choosing Button reveals the button settings below.
Icon positionBefore, AfterWhether the file-type icon sits before or after the title.
Text colorcolourLink or button text colour.
Text color (hover)colourText colour on hover and keyboard focus.
Font familyDefault, or a Google FontDefault inherits your theme's font. Choosing a Google Font loads it from Google Fonts on pages that show materials.
Font size0 to 100 (px)Text size of the list.
Button fill colorcolourButton background. Button list type only.
Button fill color (hover)colourButton background on hover and focus.
Button border radius0 to 100 (px)Corner rounding; 100 gives the pill shape.
Button border thickness1 to 10 (px)Border width.
Button border colorcolourBorder colour.
Button border color (hover)colourBorder colour on hover and focus.

Colour fields open the WordPress colour picker with an extra transparency slider, so a fill can be semi-transparent or fully transparent (the Button 1 preset uses a fully transparent fill).

The settings page with the Button 1 preset loaded, showing the additional button fill, radius, thickness, and border colour fields

What the two list types look like

Link:

Materials tab showing three materials as a plain link list with icons

Button (Button 1 preset):

Materials tab showing the same three materials as outlined pill buttons

Notes

  • Styles apply everywhere the list renders, in the Materials tab and anywhere you place the shortcode.
  • The Font family option makes a request to Google Fonts from the visitor's browser. If your privacy policy avoids third-party font loading, leave it on Default.
  • For anything beyond these settings, target the list's CSS classes from your theme; see 8.3 Shortcode and CSS Reference.