• English
  • Footer & ICP Beian

    The site footer appears at the bottom of every page. ModernDuang gives you control over copyright information, social media links, custom HTML content, and ICP record-filing (Beian) numbers required for websites hosted in mainland China.

    Configuration

    The footer is configured under the footer key in _config.modernduang.yml:

    footer:
      since: 2024
      author: ''
      powered: true
      social:
        travelling: true
        github: true
        email: false
        custom: []
      custom: ''
      beian:
        icp: ''
        moe: ''
        chabei: ''
    PropertyTypeDefaultDescription
    sincenumberThe year your site was launched
    authorstring''Site author/owner name displayed in copyright
    poweredbooleantrueShow "Powered by Hexo & ModernDuang" attribution

    The copyright line auto-generates from since and author:

    © 2024 – 2026 YourName. All rights reserved.
    • The start year is taken from since
    • The end year is the current year (auto-updates)
    • If since equals the current year, only a single year is shown: © 2026 YourName

    If author is empty, the copyright line uses the site title from Hexo's _config.yml as a fallback.

    Powered By

    When powered: true, the following line appears below the copyright:

    Powered by Hexo & ModernDuang

    Both "Hexo" and "ModernDuang" are linked to their respective project websites.

    The footer can display a row of social icon links, configured under footer.social:

    footer:
      social:
        travelling: true
        github: true
        email: false
        custom: []
    PropertyTypeDefaultDescription
    travellingbooleantrueShow the Travellings (开往) link
    githubbooleantrueShow GitHub icon (uses URL from profile.social)
    emailbooleanfalseShow Email icon (uses URL from profile.social)
    customarray[]Custom social icon items

    How Icons Resolve URLs

    The github and email toggles automatically pull their URLs from your profile social links (profile.social). For example, if you configured:

    profile:
      social:
        - name: GitHub
          url: https://github.com/yourname
          icon: github

    Then footer.social.github: true will display a GitHub icon pointing to https://github.com/yourname.

    If the corresponding social entry is not found in profile.social, the icon is hidden regardless of the toggle.

    Custom Social Icons

    You can add arbitrary social icons that are not tied to profile links:

    footer:
      social:
        custom:
          - name: RSS
            url: /atom.xml
            icon: rss
            color: '#FF6600'
          - name: Telegram
            url: https://t.me/yourchannel
            icon: '<svg viewBox="0 0 24 24" ...>...</svg>'
            color: '#0088cc'
    PropertyTypeDefaultDescription
    namestringrequiredDisplay name (tooltip)
    urlstringrequiredLink URL
    iconstringrequiredBuilt-in icon name or inline SVG string
    colorstringHover background color (CSS value)

    See the Social Icons page for the full list of 11 built-in icon names.

    You can inject arbitrary HTML content into the footer using the custom property:

    footer:
      custom: '<p style="text-align:center; font-size:0.85em;">Hosted on <a href="https://vercel.com">Vercel</a>. All content licensed under CC BY-NC-SA 4.0.</p>'

    The custom HTML is rendered below the copyright line and above the Beian information. Any valid HTML is accepted, but note that:

    • Inline styles are supported
    • Script tags may be stripped by Hexo's rendering engine
    • The HTML is inserted raw, so be careful to close all tags

    ICP Beian (Record Filing)

    If your website is hosted in mainland China, you are legally required to display an ICP (Internet Content Provider) record-filing number in the footer. ModernDuang supports three Beian formats:

    footer:
      beian:
        icp: ''       # MIIT Beian
        moe: ''       # Moe Beian
        chabei: ''    # Chabei Beian

    MIIT Beian (beian.icp)

    The standard MIIT (Ministry of Industry and Information Technology) ICP filing number:

    beian:
      icp: "京ICP备12345678号"

    Renders as:

    京ICP备12345678号

    The entire string is displayed as-is and linked to https://beian.miit.gov.cn/. You must include the full Beian number exactly as issued by the MIIT.

    Moe Beian (beian.moe)

    The Moe ICP filing (萌ICP备), a community-managed alternative for personal websites:

    beian:
      moe: "123456"

    Renders as:

    萌ICP备123456号

    The theme automatically prepends "萌ICP备" and appends "号" to your numeric code. Official site: https://icp.gov.moe/join.php.

    Chabei Beian (beian.chabei)

    The Chabei ICP filing (茶ICP备), another community Beian service:

    beian:
      chabei: "123456"

    Renders as:

    茶ICP备123456号

    The theme automatically prepends "茶ICP备" and appends "号". Official site: https://icp.redcha.cn/.

    Display Order

    If multiple Beian numbers are set, they are displayed in this order:

    1. MIIT (icp)
    2. Moe (moe)
    3. Chabei (chabei)

    Each entry is separated by a vertical bar (|) divider.

    Complete Example

    Here is a fully configured footer:

    footer:
      since: 2023
      author: Zhang Wei
      powered: true
      social:
        travelling: true
        github: true
        email: true
        custom:
          - name: RSS
            url: /atom.xml
            icon: rss
            color: '#FF6600'
      custom: '<p>Hosted on <a href="https://vercel.com">Vercel</a> with ❤️</p>'
      beian:
        icp: "京ICP备12345678号"
        moe: "123456"

    This footer would render as:

    ┌───────────────────────────────────────────────┐
    │  © 2023 – 2026 Zhang Wei. All rights reserved. │
    │     Powered by Hexo & ModernDuang               │
    │  Hosted on Vercel with ❤️                      │
    │  [🌐] [🐙] [✉️] [📡]                           │
    │  京ICP备12345678号 | 萌ICP备123456号           │
    └───────────────────────────────────────────────┘
    • Profile Card — Where github and email footer icons get their URLs
    • Social Icons — Full list of built-in icon names for custom footer items
    • Navigation & Menus — Top nav bar (above the main content, opposite the footer)