Contributing | ethereum.org

Ethereum.org is an open-source run project with 12 000+ contributors that help translate, write, design and maintain the website.

We are a welcoming community that will help you grow and educate in the Ethereum ecosystem while also meaningfully contribute and get relevant practical experience!

Ways to contribute

Translations

Join the translation program – Help us bring ethereum.org to new languages

Development

Work on an open issue (opens in a new tab) – Work we've identified that needs doing

Design

Help design the website – Designers of all levels can contribute to improve the website

Content

Create/edit content – Suggest new pages or make tweaks to what's here already
Write a builder article - Contribute an article for the Latest section
Add community resources – Add a helpful article or resource to a relevant page
Suggest a report - Suggest a research report for the Reports page
Share your story - Submit a story about your personal experiences with open-source and sanctuary technologies, how the Ethereum ecosystem has impacted your life, or how you and your community use Ethereum
Quizzes – Add, update, and delete quiz question banks for a relevant page
Suggest a design resource – Add, update, and delete helpful design resources
Suggest a video – Suggest an educational video for the video gallery

Feature ideas

Request a feature (opens in a new tab) – Let us know about any ideas you have for a new feature or design

Product listings

Add an exchange – Add an exchange to our exchange finder
Add a product – Add a dapp or wallet to a relevant page
Add developer tools – Add a developer tool to a relevant page
Add a layer 2 – Add a layer 2 to a relevant page
Add a staking product or service – Add a project that helps facilitate solo staking, pooled staking, or staking as a service
Add a wallet – Add a wallet for the find wallets page
Suggest a project for our DeSci page – Add a project built on Ethereum that contributes to decentralized science
Add a resource – Add a useful resource to any relevant page

Any questions? 🤔 Join our Discord server (opens in a new tab)

Good first tasks to start contributing

These are few current tasks that you could help us solve and take responsibility for. For most you will need GitHub account as most changes to the website are made through GitHub.

by nloureiro

Swiper a11y slide messages use missing i18n keys ("previous"/"next" not in common.json)

by alerodriargui

Update CryptoSD meetup link to HTTPS

by lufa23

Mention Vyper's module system on the languages page

by alerodriargui

Deprecated Goerli testnet: goerli.etherscan.io (HTTP 521) and goerli.optimism.io (DNS failure)

by lufa23

Suggest a developer tool

by myelinated-wackerow

RSS feed should reference post images via `<media:content>`

by hieronx

[Content] Add dedicated ERC-7540 page

by myelinated-wackerow

Add replacement grant directory resources to community grants page

by awixor

Add quiz questions on DeFi

by wackerow

Documentation request: interacting with smart contracts

See all tasks

How to work on ethereum.org

If you wish to contribute in the Translation Program, we ask you to create an account on Crowdin (opens in a new tab). For everything else – adding or editing content or visuals to the website, fixing bugs, working on open tasks – you will need a GitHub (opens in a new tab) account.

All updates are made via the GitHub PR process. This means you create a local copy of the website, make your changes and request to merge your changes. If you've never done this before, follow the instructions at the bottom of our GitHub repository (opens in a new tab).

You don't need permission to work on anything, but it's always best to let us know what you're planning to do. You can do this by:

Commenting on an issue or PR in GitHub (opens in a new tab)
Messaging on our Discord server (opens in a new tab)

Before contributing, make sure you're familiar with:

How decisions about the site are made

Decisions about individual PRs, design evolution and major upgrades are made by a team from across the Ethereum ecosystem. This team includes project managers, developers, designers, marketing and communications, and subject matter experts. Community input informs every decision: so please raise questions in issues, submit PRs, or contact the team:

A note on plagiarism

Only use your original work or content that you have permission to use when contributing any content or artifact to ethereum.org. Many projects within the Ethereum ecosystem use open-source licensing that allows for the free sharing of information. However, if you cannot find this information, do not attempt to add it to ethereum.org. Any pull requests deemed as plagiarism will get rejected.

New to open-source?

We have low barrier to entry issues on our GitHub repository specifically designed for developers who are new to open-source labelled good first issue (opens in a new tab).

Claim your Onchain Achievement Token (OAT)

If your contribution gets merged into ethereum.org, you will have a chance to claim a special badge on Galxe (opens in a new tab). An Onchain Achievement Token (OAT) is a proof that you helped make the ecosystem a little more awesome.

How to claim

Join our Discord server (opens in a new tab).
Paste a link to your contribution in the #🥇 | proof-of-contribution channel.
Wait for a member of our team to send you a link to your OAT.
Claim your OAT!

You should only use self-custody wallets to claim OATs. Do not use exchange accounts or other accounts you do not hold the private keys to, as these will not allow you to access and manage your OATs.

Claim your GitPOAP

GitPOAP will also automatically recognize your merged contribution and let you mint a separate unique contributors POAP on their platform itself!

How to claim

Visit GitPOAP (opens in a new tab).
Connect with your wallet or even with your email through sign in option.
Search for your GitHub username, ETH address, ENS names or any GitPOAP to check if you're eligible.
If your GitHub account is eligible, then you would be able to mint a GitPOAP!