Skip to main content

8.2 Settings Reference

Two places hold settings: the per-item fields on each course, lesson, topic, or quiz's Settings tab, and the site-wide style settings at Settings > Learndash Materials.

Per-item fields (Settings tab of a course, lesson, topic, or quiz)

Shown beneath LearnDash's materials editor while that item's Materials toggle is on.

FieldValuesDefaultNotes
TitletextemptyLink text.
SourceFrom Media Library, External URLFrom Media LibrarySwitches the File field between a Select button and a URL box.
File (Media Library)a Media Library filenoneChosen in the WordPress media window; filename shown next to Select.
File (External URL)URLemptyEnter the full address including https://; addresses without a scheme are prefixed with http://.
Link actionDownload, Attachment pageDownloadMedia Library items only. Download links to the file; Attachment page links to its WordPress page.
Open in new tabon/offoffAdds target="_blank" to the link.

Controls: Add item appends a row; × removes a row; drag a row to reorder; Insert shortcode adds [learndash_materials_extended] to LearnDash's materials editor once.

Site-wide style settings (Settings > Learndash Materials)

SettingValuesField defaultNotes
Style template + LoadBasic, Button 1, Button 2BasicFills the fields below with the preset; not itself saved.
List typeLink, ButtonLinkButton reveals the button settings.
Icon positionBefore, AfterBefore
Text colorcolour#333333
Text color (hover)colour#000000Applies on hover and focus.
Font familyDefault, Google FontsDefaultA Google Font is loaded from Google Fonts on the front end.
Font size0 to 100 px16
Button fill colorcolour#545454Button only.
Button fill color (hover)colour#545454Button only.
Button border radius0 to 100 px4Button only.
Button border thickness1 to 10 px1Button only.
Button border colorcolour#545454Button only.
Button border color (hover)colour#545454Button only.

Until the settings are saved for the first time, the front end uses the Basic preset values rather than the field defaults above.

Preset values

SettingBasicButton 1Button 2
List typeLinkButtonButton
Icon positionBeforeBeforeBefore
Text color#999#999999#ffffff
Text color (hover)#555#ffffff#ffffff
Button fill colornot settransparent (rgba(153,153,153,0))#999999
Button fill color (hover)not set#999999#777777
Button border radiusnot set100100
Button border thicknessnot set11
Button border colornot set#999999#999999
Button border color (hover)not set#999999#777777

Presets only set the fields listed; Load leaves the others as they are.

Where settings are stored

For developers and support: per-item materials are saved as post meta learndash_materials_extended on the course, lesson, topic, or quiz; the shortcode itself lives in LearnDash's own materials setting for that item. The style settings are one option, ldash_materials_style_data.