FAQ
My new anime isn't showing up after I updated my AniList. Why?
The plugin caches your AniList data locally to avoid hitting the API on every build. To force a fresh fetch, run:
hexo clean
hexo generatehexo clean deletes the cache file, so the next generate will pull your latest data.
Does fetching a large list slow down my Hexo build?
Only the very first build after hexo clean makes a network request. After that, all subsequent builds use the local cache and complete instantly.
Will a big image grid slow down my website?
No. The plugin loads compressed thumbnails for the grid view. Higher resolution images are only fetched when a user opens the lightbox — and only for that specific image.
Does this work with dark mode?
Yes, automatically. The plugin uses CSS variables from your host Hexo theme (--primary-color, [data-theme]) rather than hardcoded colors, so it adapts to whatever dark/light mode your theme provides.
Can I show only specific lists?
Yes. Use the tabs field under anime or manga to specify exactly which status tabs appear and in what order. Any status not listed is excluded from the generated page.
See Customization → anime.tabs for details.
What happens if I hit the AniList rate limit?
The plugin includes automatic retry logic with exponential backoff. If the AniList API returns a 429 Too Many Requests response, the plugin waits and retries up to 3 times before failing. This is rare for normal-sized lists.
Do I need a public AniList profile?
Yes. The plugin fetches data from the public AniList GraphQL API, which requires the profile to be public. Private profiles are not accessible.
Can I use this with any Hexo theme?
The plugin generates a standalone page using your theme's base layout. It has been tested with the Redefine theme and should work with most common Hexo themes. If you run into styling conflicts, the colors.primary config option lets you override the accent color manually.