Ananke Documentation
  • Overview
  • Tutorials
    • Build your first Ananke site
  • How-to guides
    • Install as a Hugo Module
    • Install as a Git submodule
    • Update Ananke
    • Set up menus
    • Add social links
    • Add custom CSS
    • Configure page headers
    • Use hooks
    • Troubleshooting
  • Explanation
    • Choose an installation method
    • How configuration works
    • How the stylesheet is built
    • Content types and archetypes
    • Hooks and filters
  • Reference
    • Configuration reference
    • Front matter
    • Hugo version compatibility
    • Shortcodes
    • Hook catalogue
    • Layout map
  • Help
    • Contributing to the documentation
    • Developing across the Ananke repositories
    • Contributors
Mastodon
Get started

Upgrade social links from Ananke 2.10 or earlier

Ananke 2.11.0 replaced the social settings. Later releases ignore the old settings, so a site that still uses them shows no follow links. This guide moves your settings to the current structure.

Find the old settings #

Ananke 2.10 and earlier read two forms. Search your site configuration for both:

  • A list of tables named ananke_socials:

    toml
    # config/_default/params.toml (old)
    
    [[ananke_socials]]
    name = "github"
    url = "https://github.com/jdoe"
  • A flat parameter with the network name, for example github = "https://github.com/jdoe" directly under [params]. Ananke 2.10 read these names: facebook, twitter, instagram, youtube, github, gitlab, keybase, linkedin, medium, mastodon, slack, stackoverflow, and rss.

Move the settings #

  1. Add each network to the follow list, in the order that you want:

    toml
    # config/_default/params.toml
    
    [ananke.social.follow]
    networks = ["github"]
  2. Add a table for each network and copy the old url to profilelink:

    toml
    # config/_default/params.toml
    
    [ananke.social.github]
    profilelink = "https://github.com/jdoe"

    Instead of profilelink, you can set username for networks with a fixed profile address. The built-in networks table shows which networks support this.

  3. If an old entry set label, copy it to the same table. If it set color, set it in the network definition instead, for example color under [ananke.social.networks.github].

  4. Delete the ananke_socials tables and the flat network parameters.

  5. Run hugo server and check the follow links in the header and the footer.

To add share links too, see Add share links.

Update your own templates #

Ananke 2.11.0 also removed the old social partials and the functions in partials/func/socials/. If your own templates call them, change the calls:

Old callNew call
{{ partial "social-follow.html" . }}{{ partial "social/follow.html" . }}
{{ partial "social-share.html" . }}{{ partial "social/share.html" . }}
Back to contents
Improve this page on GitHub
      On this page

      On this page

      • Find the old settings
      • Move the settings
      • Update your own templates
      Ananke Documentation © Ananke Documentation 2026
      Mastodon