Skip to Main Menu


Table of Contents

Minimo supports Widgets that you can place on specific Widget Areas.

Available Widgets

Minimo has the following built-in Widgets:

Name Slug
1. About about
2. Recent Posts recent_posts
3. Social Menu social_menu
4. Taxonomy Cloud taxonomy_cloud

Widget Configuration Options

Here are the configuration options available for the Widgets:

Widget: About

  • about [Map]:
    • title [String]: Title
      default: .Site.Title
    • description [String]: Description
    • logo [String]: path/url of Logo
      default: "/images/logo.png"

Widget: Recent Posts

  • recent_posts [Map]:
    • title [String]: Title
      default: "Recent Posts"
    • length [Integer]: Number of posts to show
      default: 5
    • excludeTypes [Array of Strings]: Types of posts to exclude
      default: ["page"]

Widget: Social Menu

  • social_menu [Map]:
    • title [String]: Title
      default: ""
    • platforms [Array of Strings]: Social platform to show

Widget: Taxonomy Cloud

  • taxonomy_cloud [Map]:
    • title [String]: Title
      default: Plural Name for taxonomyCloud.taxonomy
    • taxonomy [String]: Taxonomy to show
    • shuffle [Boolean]: Shuffle Taxonomy Terms
      default: true

Available Widget Areas

Name Slug
Homepage homepage
Sidebar sidebar

You can add Widgets to Widget Areas from your config.toml file:

homepage = ["recent_posts"]
sidebar = ["about","taxonomy_cloud"]

The syntax for adding Widgets to Widget Areas is:

widget_area_slug = [ widget_slug_1, widget_slug_2, ...]

Widgets Configuration File

Minimo picks up Widgets’ configuration from the /data/config/widgets.toml file.

Here’s the Widgets Config file for this site:


# About Widget config
title = ""                            # default: .Site.Title
description = ""                      # default:
logo = "/images/logo.png"             # default: "/images/logo.png"

# Recent Posts Widget config
title = ""                            # default: "Recent Posts"
length = 4                            # default: 5
excludeTypes = ["page"]               # default: ["page"]

# Social Menu Widget config
title = ""                            # default: ""
platforms = ["github","facebook","twitter","instagram","email","codepen","gitlab","linkedin","telegram","google_scholar"]

# Taxonomy Cloud Widget config
title = ""                            # default: Plural Name for `taxonomyCloud.taxonomy`
taxonomy = "tags"                     # default: "tags"
shuffle = true                        # default: true

If configuration for any Widgets are missing in this file, Minimo will fallback to the default configuration for those Widgets.

Go wild!