> For the complete documentation index, see [llms.txt](https://hashly.gitbook.io/hashly-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://hashly.gitbook.io/hashly-docs/community/museum.md).

# NFT Museums

Build a **3D room** from the NFTs you hold, publish it, and let the community walk through it. Published museums are ranked by likes.

👉 Open it at [hash-ly.com/museum](https://hash-ly.com/museum).

***

## ⚙️ How It Works

Three rules shape every museum:

| Rule                        | What it means                                                                                    |
| --------------------------- | ------------------------------------------------------------------------------------------------ |
| 🖼️ **Hang what you hold**  | You can only hang NFTs from your connected wallet, and pieces are checked against it again later |
| 🐉 **Dragons open rooms**   | The more Santuario Hedera dragons you hold, the bigger your room                                 |
| ❤️ **One wallet, one like** | Likes rank the museums and aren't weighted by holdings                                           |

Nothing is uploaded or transferred: the museum reads what your wallet holds.

***

## 🐉 Rooms

Your room size depends on how many **Santuario Hedera dragons** (`0.0.7235629`) your wallet holds. Every room has a feature the smaller ones don't:

| Room             | Dragons needed | Works | Room feature              |
| ---------------- | -------------- | ----- | ------------------------- |
| 🚪 **Alcove**    | None (free)    | 4     | Entrance lectern          |
| 🖼️ **Gallery**  | 1              | 13    | Cordoned centrepiece      |
| 🏛️ **Pavilion** | 5              | 29    | Rotunda drum              |
| 🏰 **Wing**      | 10             | 52    | Hexagonal kiosk           |
| 👑 **Santuario** | 20             | 83    | Obelisk and reading table |

**Works** counts every NFT a room can show: pieces on the walls, plus the displays on the floor in the larger rooms, such as the display case in the centre.

### 🖼️ Frames

You choose a frame for each piece. The frames available to you depend on what you hold:

| Frame         | Who can use it                                 |
| ------------- | ---------------------------------------------- |
| 🟨 **Gold**   | Everyone                                       |
| ⬛ **Black**   | Everyone                                       |
| 🟫 **Walnut** | Wallets with at least 1 dragon                 |
| ✨ **Ornate**  | Holders of an El Santuario NFT (`0.0.9954622`) |

An El Santuario NFT only adds the ornate frame. Room size comes from dragons alone.

***

## 🛠️ Build Your Museum

1. Go to [hash-ly.com/museum](https://hash-ly.com/museum) and click **Build your museum** (or **Open your museum** if you already have one).
2. Connect your wallet. Your room opens at the size your dragons allow.
3. Click any **+** on a wall, or on the display case, to open the picker. It lists the NFTs in your wallet that have readable art.
4. Pick an NFT to hang it there. Picking one that is already on a wall moves it.
5. Click a hung piece to change its **frame** or to **Take down** the piece.
6. Name your museum (up to 60 characters) and click **Save**.
7. Click **Publish**. Your museum is now public at `hash-ly.com/museum/<your wallet>`, and you can **Unpublish** it at any time.

> ⏳ The first time you open the picker it can take a few seconds: the art lives on IPFS and Arweave and has to be fetched once.

***

## 🔍 Holdings Checks

* 🔄 **Sold pieces**: your pieces are checked against your wallet when you publish and whenever you open your museum editor. A piece that has left your wallet **stays on the wall, marked as sold**, until you take it down. Visitors see the note in its close-up.
* 📉 **Fewer dragons**: if you now hold fewer dragons, your room gets smaller. Pieces that no longer fit aren't shown, and they're removed the next time you save.
* 🖼️ **Frames**: if you no longer hold what a frame requires, the piece goes back to gold the next time you save.

***

## ❤️ Likes and Ranking

* 👛 **Connect your wallet** to like a museum. Click the heart again to remove your like.
* 🙅 **You can't like your own museum.**
* ⚖️ **One wallet, one like**: likes aren't weighted by dragons or other holdings.
* 🏆 **Ranking**: [hash-ly.com/museum](https://hash-ly.com/museum) lists published museums with at least one piece, most liked first. When two museums have the same likes, the one published first ranks higher. The first 10 show up front, and **See more museums** loads the next ones.

***

## 🚶 Visiting a Museum

* 🔄 **Look around**: drag to orbit the room and scroll to zoom.
* 🚶 **Walk mode**: switch to walk through the room.
* ⛶ **Fullscreen**: open the room in fullscreen.
* 🔍 **Close-up**: click a piece to see its name, token ID and serial, its collection's floor price, owners and minted supply (when Hashly tracks that collection), and links to SentX, HashScan and, when there is one, the collection's page on Hashly.
* 📤 **Share**: copy the museum's link or use your device's share sheet.

***

## 💡 Tips

* 🐉 **Check the ladder**: the museum page shows your current room and how many more dragons open the next one.
* 🖼️ **Use the display case**: from the Gallery up, one piece stands in the centre of the room.
* 🔄 **Open your editor after selling NFTs**: sold pieces stay marked until you take them down.
* 📚 **Big collections**: the picker reads up to 400 NFTs from your wallet, 60 at a time (use **Load more**).

***

> ⚖️ **Please note:** Santuario Hedera dragons and El Santuario NFTs are **utility tokens**: digital collectibles that unlock features on Hashly, such as voting power, staking, bigger museum rooms and raffle requirements. They aren't securities, shares, investment contracts or financial instruments. Holding one gives no ownership of Hashly and no right to profits, dividends or revenue. They aren't offered as an investment, and nobody should acquire one expecting a profit. Their marketplace prices are set by buyers and sellers, and Hashly doesn't control or guarantee them. Floor prices and collection stats shown in museums are information only. Nothing on Hashly is financial or investment advice. See the [Terms of Use](https://hash-ly.com/terms).


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://hashly.gitbook.io/hashly-docs/community/museum.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.