Customization

All configuration goes under the anilist: key in your Hexo root _config.yml.

Full Example

Here's a complete configuration for reference. All fields except enable and username are optional.

anilist:
  enable: true
  username: "your_anilist_username"
  path: anime
  page:
    title: "My AniList"
    columns: 6
    page_items: 18
  colors:
    primary: "#3db4f2"
  anime:
    subtitle: "Too much to watch, not enough time."
    tabs:
      - "Watching"
      - "Completed"
      - "Planning"
  manga:
    subtitle: "Reading occasionally"
    tabs:
      - "Reading"
      - "Completed"

enable

boolean · Required · Default: false

Enables the plugin. Must be true for the gallery to generate.

username

string · Required · Default: ""

Your AniList profile username. The profile must be set to public.

path

string · Optional · Default: anime

The URL route where the gallery is generated. Setting this to library makes the page available at your-site.com/library/.

page.title

string · Optional · Default: My anime list

The HTML page title used in the browser tab and for SEO.

page.columns

integer · Optional · Default: 4

Number of card columns across the grid. 5 or 6 works best on wider screens.

page.page_items

integer · Optional · Default: 20

Number of cards per page before pagination appears.

colors.primary

string (hex) · Optional · Default: #3db4f2

Fallback accent color used for buttons, active tabs, and focus indicators. Only applies when your Hexo theme does not expose a --primary-color CSS variable.

anime

Required for the anime gallery to appear. If this block is absent, no anime content is rendered and the type switcher won't show.

anime.subtitle

string · Optional

Short text displayed beneath the page title on the anime gallery view.

anime.tabs

string[] · Optional

Controls which status tabs appear and in what order. Any status not listed is excluded from the page entirely. If omitted, all lists from your AniList account are shown.

Valid values: Watching, Completed, Planning, Paused, Dropped

anime:
  tabs:
    - "Watching"
    - "Completed"
    - "Planning"

TIP

Use tabs to hide lists you don't want public — like Dropped or Paused — without changing your AniList account settings.

manga

Optional. When absent, the manga gallery is hidden entirely. When both anime and manga are configured, a type switcher appears at the top of the page.

manga.subtitle

string · Optional

Same as anime.subtitle, shown on the manga view.

manga.tabs

string[] · Optional

Same as anime.tabs. Valid values: Reading, Completed, Planning, Paused, Dropped