Skip to main content
Custom Website Page Welcomer
Hayami has support for some websites out-of-the-box, but due to the plethora of rapidly-growing online forums, communities, and anime streaming websites globally, Hayami may not support everything at once. But, with custom websites, any site can support Hayami, setup by you. If you want a GIF instead of a wiki-style guide, an example is below for your convenience.
Note that the GIF below is one such example, and there’s many modes you can mount Hayami onto sites. See the full documentation for more details.
Custom Mapping Hayami

How to configure custom websites with Hayami

Right click on the website you want to map to Hayami, and click “Map this site to Hayami”. If Hayami doesn’t have permission to access the site, you may get a popup requesting this permission. If you do, click ‘Allow’.
Image
You should be faced with the ‘Map this site to Hayami’ prompt, allowing you to configure many features. You’ll need to choose how you want Hayami to mount onto the site.

Choosing your mapping mode

Image(1)
See how each rendering mode performs down below.
Below element: This puts the Hayami comments section below such element. You might want to put it below an existing comments section, below a title on the page, or just literally at the end of the page (HTML “body”). Choice is yours. An example is shown on below on a simulated anime platform example with just a video player with nothing on-page. There are many other use-cases this mode works effectively.
Custom Mapping Hayami
Once you’ve made your selection, select it, and continue on with the guide.

How to choose anime title and episode

Choosing the anime title and episode selector can vary by site, but Hayami should make it fairly straightforward. You can do this either via manually selecting it. Anime title selector: Click ‘Pick’ and choose the name of the anime on the site.
Image
Episode selector: Choose the episode number on the page. Refrain choosing elements added by other extensions (e.g. MAL-Sync).
Image
For popup only, no extra configuration required, your all done from here.

Setting mount selector, and side padding

For all the other modes, one last step: you need to configure the rest.
Image
Mount selector: Where comments should appear or icon should sit. You can put “body” to append Hayami to the end of the page, if desired. Display target selector: This can be ignored. Side padding: How much y-padding is added to each side of the Hayami comments section. I’d recommend 240 side padding, but you can adjust how you wish. After clicking “Save & Embed” (might also need a page refresh), the comments section should be successfully embedded.

How to import & export custom website mappings

You can export custom site mappings by clicking on Hayami, clicking on:
Settings > Custom websites > (i) Info icon on website you want to export > Export
Image
You can share this custom mapping file for others to import (on Custom websites settings page), if desired. Once you’ve imported a new custom website mapping, you may notice the Hayami extension with a (!) badge.
Image
This indicates you need to allow the extension permission to access the site as a host. Open the Hayami popup, you should see a prompt to allow those permissions.
Screenshot 2026 03 13 161701

How to sync with custom website mappings

Community members who have combined multiple mappings into one may update their mappings regularly as a visitor of many sites and forums. If you want to import and sync regularly with these mappings, you can do so by going to Hayami settings > Custom websites > Custom Sites Sync > New source, and adding the URL to the sync location.
Image

How to make your own custom website sync location

Using the above guide on importing/exporting your custom-made Hayami mappings, you can then make your own sync to share with others in the community by doing the following:
1

Export all the custom sites you want to export via Hayami custom websites.

Click on the info icon on each individual site, and export the sites you want to merge into one configuration intended for sync.
2

Merge all of these site mapping files into a single one using Hayami's site merger.

Using Hayami’s custom site merger (https://custom-site-merger.hayami.moe/), upload all of your site mapper configurations (it’s processed locally), and export them as one config by clicking ‘Download JSON’.If you’ve already got your exported JSON, the importer also supports expanding your existing mapping, so you can import that file in-future to expand it if desired, if your editing your gist.
Image
3

Upload this JSON to a Gist site, Pastebin, or web host - which you can edit.

GitHub Gist (https://gist.github.com/) will be used in the following example. Drag to import your exported JSON directly into GitHub Gist, or open up your JSON and just copy and paste it directly.
Githubgist Mappingsyncsave
Then click ‘Create secret gist’, which should create the Gist successfully.
4

Click 'Raw' to get the URL to share with others, then change out the URL slightly.

Image
Image
The portion after /raw would mean we’d only sync to this version everytime, no matter if you update it. We don’t want that. Remove everything after /raw, so it looks like this.
Image
This URL can be shared with others to sync their custom sites with your mappings.
5

Whenever you wish to edit your mapping, just click Edit.

Image
Edit your mapping, hit save, and it’ll sync across to others as well whenever their weekly sync is due. Or you can tell your community you’ve updated it, and they can manually click ‘Sync now’ if they prefer.