Hats Protocol Docs
hatsprotocol.xyzGithub
  • ๐Ÿ‘‹Welcome to Hats Protocol
  • ๐ŸงขGetting Started with Hats
  • โญQuick Start
  • Using The Hats App
    • ๐Ÿค Essentials For Hat Wearers
    • ๐ŸŽฉCreating My First Hat
    • ๐Ÿง™Admins: Creating, Issuing, and Revising Hats
    • ๐Ÿ‘ฅWhat Hats Do I Need?
    • ๐ŸŒณDrafting, Exporting, and Deploying Tree Changes
    • ๐Ÿ—๏ธSetting a Hat's Basic Properties
    • ๐ŸฅณAdding Wearers
    • ๐Ÿ”Connecting Hats w/ Permissions & Authorities
      • Types of Hat-Powered Authorities
      • Connecting Hats to Token Gates
        • Hats Protocol Contract Addresses
        • Finding a Hat's Token ID
      • Documenting Hat Powers & Responsibilities
    • ๐ŸŒŸRevocation & Eligibility: Requirements for Wearers
    • โšกDeactivating & Reactivating Hats
    • โœ…Making Hats Claimable
    • ๐Ÿ”—Linking Trees Together
    • โ›“๏ธHats Protocol Supported Chains
    • โ“Glossary & FAQ
  • Hats Integrations
    • ๐Ÿ”Permissions & Authorities
      • Coordinape
      • Council Voting Vault
      • Charmverse
      • Discord
        • Collab.Land --> Discord
        • Guild.xyz --> Discord
      • Farcaster Casting Rights
      • Fileverse
      • Google Workspace
      • Hats Account
      • Role-Based Compensation
      • Safe Multisig Signing Authority
      • Telegram
        • Collab.Land --> Telegram
        • Guild.xyz --> Telegram
      • Snapshot: Voting, Weight & Proposal Creation
      • Wonderverse
    • ๐ŸŒŸEligibility & Accountability Criteria
      • Agreement Eligibility
      • Allow-List Eligibility
      • CoLinks Eligibility
      • ERC20 Eligibility
      • ERC721 Eligibility
      • ERC1155 Eligibility
      • Hat-Wearing Eligibility
      • Hats Election Eligibility
      • JokeRace Eligibility
      • Pass-Through (Hat-Based) Eligibility
      • Staking Eligibility
      • Subscription or Membership Fee (Unlock Protocol)
      • Gitcoin Passport Eligibility
    • โšกActivation & Deactivation Criteria
      • Seasonal/ Time-Expiry Toggle
      • Pass-Through (Hat-Based) Toggle
    • ๐Ÿ‘ทHatter Modules
      • Multi Claims Hatter
      • DAOhaus Moloch v3 Membership & Share Allocation
  • For Developers
    • ๐Ÿ‘ทHats Protocol, for Developers
      • Hat Properties
      • Wearing a Hat
      • Hat Admins & Hatter Contracts
      • Hats Trees
      • Hat IDs
      • Linking Hats Trees
      • Eligibility Modules
      • Toggle Modules
      • Hat Mutability and Editing
      • Creating Hats
      • Minting Hats
      • Transfering Hats
      • Renouncing Hats
      • Batch Actions
      • Hat Image URIs
      • ERC1155 Compatibility
      • โ›“๏ธSupported Chains
    • ๐Ÿค–v1 Protocol Spec
      • Hats.sol
      • HatsEvents.sol
      • HatsErrors.sol
      • HatsIdUtilities.sol
      • Interfaces
        • IHats.sol
        • IHatsIdUtilities.sol
        • IHatsEligibility.sol
        • IHatsToggle.sol
    • ๐Ÿ–ฅ๏ธv1 SDK
      • Core
        • Getting Started
        • Onchain Reads
        • Onchain Writes
        • Multicall
        • Claiming Hats
        • Utilities
      • Subgraph
        • Getting Started
        • Fetching Hats
        • Fetching Wearers
        • Fetching Trees
        • Misc
        • Types
      • Hat Details
        • Getting Started
        • Usage
    • ๐Ÿ”ญv1 Subgraphs
    • ๐ŸงฉHats Modules
      • ๐Ÿ”ŒModules SDK
        • Getting Started
        • Get Available Modules
        • Create New Instance/s
        • Composing Modules
        • Interact With Instances
        • Utilities
        • Types
      • โš’๏ธBuilding Hats Modules
        • Inside a Hats Module
          • Immutable Arguments
          • Module Setup
          • Versioning
        • Creating New Modules
        • How Module Instances Are Deployed
        • Modules Registry
        • About Module Chains
    • ๐Ÿ”Hats Signer Gate v2
    • ๐Ÿ‘’Hats Signer Gate SDK
      • Getting Started
      • Creating New Instances
      • Hats Signer Gate
      • Multi Hats Signer Gate
      • HSG & MHSG Handlers
    • ๐Ÿ’ผHats Account SDK
      • 1 of N Hats Account
        • Getting Started
        • Creating New Instances
        • Executing From An Instance
        • Constants
        • Types
    • ๐ŸŒHats Security Audits
  • Legal
    • Terms
      • Terms of Service
      • Acceptable Use
      • Privacy Policy
      • Cookie Policy
      • Attribution
Powered by GitBook
On this page
  • 1. Creating a new tree
  • The Top Hat
  • To create a new tree
  • 2. Creating your first child hat
  1. Using The Hats App

Creating My First Hat

PreviousEssentials For Hat WearersNextAdmins: Creating, Issuing, and Revising Hats

Last updated 6 months ago

Hats Protocol is flexible and powerful enough to serve as the backbone for your decentralized work, comprising the roles, responsibilities, authorities, and accountabilities across a community or organization.

While there are many ways you can deploy Hats to support your decentralized work, getting started is simple.

You can get started with Hats in two steps:

  1. Creating a new tree

  2. Creating your first child hat

Following are instructions for creating a new Hats tree and your first child hat:

1. Creating a new tree

In either case, the first step to creating a new Hats tree is to create the "Top Hat": the root of a Hats tree which serves as a super-admin for all of the other hats that will be added to the tree.

The Top Hat

The broadest authority of your Hats tree is represented by the Top Hat. This is the first hat you will create; you can think of it as the super-admin of the entire Hats tree. Top Hats should be worn by the highest-level governance surface of your organization. That said, when you're just getting started it's usually OK to first mint the Top Hat to an address you control and then transfer the Top Hat to the organization's address later.

To create a new tree

  • Connect your wallet

  • Add an image

  • Enter the name and description for your new Hats Tree (the name and description of a Top Hat effectively serves as the name and description for its full tree)

  • Enter the address that will wear this Top Hat (see The Top Hat above for recommendations on where to mint the Top Hat)

  • Ensure you are creating this tree on the right network; you can change the network by selecting the network icon in the banner

  • Select "Create" and confirm the transaction through your wallet

2. Creating your first child hat

Once your new tree is created with the tree's Top Hat minted to an address you control, you can create your first child hat(s). To create a child hat:

  • Select "Edit Tree"

  • On the Top Hat's card, select "Create Hat <child hat ID>"

  • You can continue to use Edit Mode to add as many hats and change any details for existing hats as you wish, making sure to click "Save" after each change.

  • Finally, select "Deploy" to update your changes in the chain.

After you've created a new Hats tree and your first child hat, you will be ready to to give all wearers of the hat the and accountabilities they need to get things done.

Hats are organized in a tree structure, called a "Hats tree". Each tree can hold all the hats for a given organization, or you could create a new tree for each team or project ().

Visit the

Select "Create a new tree" ()

You'll be able to , , create/add and/or modules and more. As long as you keep the hat for now, you can always change these properties later as long as you're wearing a hat that is an admin of this new hat (such as the Top Hat, which is an admin for all other hats in the tree).

Congratulations, you've created a new Hats tree and your first child hat! You can now continue to create additional hats throughout the tree. See for suggestions on which hats your group may need.

Each of the hats you create can then be and to give them the authorities associated with those hats.

๐ŸŽฉ
add wearers
authorities
you can always link trees together later
Hats app
or visit this link
What Hats Do I Need?
connected with authorities
minted to one or more wearers
set the hat's basic details
add wearers
eligibility
toggle
First create a new Hats tree , then follow the instructions in this video to build out your structure with additional Hats
using this link
Creating a new Hats tree starts with creating that tree's Top Hat
mutable