MC-Guide

Content Writing

Website 125: a11yproject.com

How Can You Earn Money Writing For “a11yproject.com” Website

This guide shows you, step by step, how a beginner can learn to pitch and sell stories to a11yproject.com

You will learn what a11yproject.com wants, how to test your idea, how to write a pitch, and how payment roughly works. You can use this like a small SOP.

A11Y Project · Writer Snapshot
Pay: $75 per published post (per their page) Style: short, clear, beginner-first Content: myths · tips · tests · how-tos · experiences Audience: new learners → pros Goal: practical accessibility help
Ideal for writers who want to teach real-world accessibility using simple language, tested steps, and respectful, inclusive examples — with a strong focus on what actually helps people.

Content Writing · 03 Beginner Friendly Target: a11yproject.com

Guide: How to Get Paid to Write for The A11Y Project (Step by Step)

This guide shows you, in simple steps, how you can learn accessibility, write a strong article, and pitch it to The A11Y Project — even if you are new to digital accessibility and new to writing for publications.

You’ll learn what they publish, how to pick an idea that fits, how to write in their style, how to submit (with or without GitHub), and how to use your published article to earn more money later (more clients, better paid guest posts, and stronger authority). Sentences are simple. You can treat this like a mini SOP.

Quick link hub: Write for Us · Contributing Guidelines · Content Style Guide · Code of Conduct · Checklist · Resources

What The A11Y Project is — and why writing here helps you earn

The A11Y Project is a community-driven website that helps people learn digital accessibility (often written as “a11y”). The goal is simple: make websites, apps, and digital content easier to use for everyone. Their content is written for beginners first — but it also helps experienced people refresh the basics.

If you want to earn money as a writer, accessibility is a strong niche. Why? Because companies must ship usable digital products, and many teams still struggle with accessibility. A clear, respectful, beginner-friendly article can bring you:

🧠
Authority: your byline becomes “proof”

When you publish on a recognized learning site, your writing becomes a public sample. Editors, clients, and employers can see how you explain complex topics in simple words.

  • Use your A11Y Project link in future pitches (to other sites).
  • Use it in your portfolio and LinkedIn.
  • Use it to get accessibility consulting gigs, audits, or training work later.
💰
Direct pay + long-term money path

The A11Y Project also pays for published content (so it is not “exposure only”). But the bigger win is what your byline unlocks after: higher paid guest posts, clients, and recurring writing work.

  • Start with one small post here.
  • Turn that post into 3–5 paid pitches elsewhere.
  • Build a niche reputation around accessibility.

Before you write anything, read these key pages and keep them open in tabs: Write for Us, Contributing Guidelines, Content Style Guide, and Code of Conduct. These pages tell you what content they accept and what they reject.

Where you’ll use this guide What you’ll produce How it helps you earn
The A11Y Project Short, beginner-first post (myth, tip, test, how-to) Paid post + strong public sample
Your own blog Expanded version, extra examples, local SEO angle Traffic + affiliate + consulting leads
Guest posts / magazines Case study, opinion, or “how we fixed it” story Higher rates + recurring assignments
Clients Accessibility audits, writing, UX fixes, training Highest pay, long-term work
Explore these site sections (you’ll reference them often): Posts · Spotlight · Resources · Checklist · About

Pick an idea that fits (without guessing)

Most beginners fail because they choose ideas that are either too broad (“Accessibility is important”) or too technical (“ARIA properties, all of them”). The A11Y Project works best when you pick a small, practical slice that a beginner can apply today.

Use these fast “idea checks” to make sure your topic fits:

1
Check 1

Is it beginner-first and easy to apply?

Their audience includes complete beginners. So your post should help someone who is new to accessibility take a clear step forward, without needing a big budget or special software.

  • Good: “How to do a keyboard-only check in 5 minutes.”
  • Good: “Myth: automated tools catch everything (they don’t).”
  • Not great: “The full history of WCAG in extreme detail.”
2
Check 2

Does it match one of their 7 content types?

The A11Y Project lists seven main content types (you’ll learn them in the next section). If your idea can’t fit into one of those shapes, rewrite it until it can.

  • Can this be a myth, tip, test, how-to, experience, background, or assistive tech post?
  • If yes, it will feel “native” to their site.
3
Check 3

Can you prove it with a tiny demo or real test?

Accessibility writing must be trusted. Your post is stronger when you can show:

  • A quick before/after (bad example → fixed example).
  • A short checklist you personally ran (keyboard, zoom, contrast).
  • A real tool walkthrough (NVDA basics, VoiceOver basics, etc.).
4
Check 4

Does it avoid “promotion energy”?

The A11Y Project is careful about promotions, referral schemes, and backlink deals. Your post should teach, not sell.

  • Write like a helpful teacher, not a marketer.
  • If you mention tools, mention them because they are credible and helpful, not because you earn affiliate money.
Where to get idea inspiration: Browse Posts, and also look at the community “post ideas” list on GitHub: List of Post Ideas. Don’t copy titles — use them to find gaps and build your own version.

The 7 content types (with beginner templates you can copy)

The A11Y Project says they publish seven main kinds of content. This is important because editors can approve your pitch faster when you tell them exactly which type you’re writing.

Below is a clear map of the seven types, plus a simple template for each. Use these templates like LEGO blocks. Keep your post short, focused, and respectful.

Content type What it is Best for beginners Mini template (structure)
Background General concept explanation that helps people think clearly about accessibility. Yes, if you keep it small and practical. 1) What it is
2) Why it matters (real impact)
3) Common mistakes
4) What to do instead
5) Links to learn more
Myth Short post that debunks a common misconception. Perfect first post. 1) Myth statement
2) Why people believe it
3) Why it’s wrong (simple proof)
4) Better truth
5) Quick actions
Quick test A short set of steps to check if content is accessible. Perfect if you can test it yourself. 1) What you’re testing
2) Why it matters
3) Steps (numbered)
4) What “pass” looks like
5) Fix tips
Quick tip Small, easy-to-implement advice with strong ROI. Great for beginners. 1) The tip (one sentence)
2) Bad example
3) Better example
4) One “why” line
5) Links
Assistive technology Background info on tools people use to navigate digital interfaces. Yes, if you keep it basic and respectful. 1) What it is (plain)
2) Who uses it (avoid stereotypes)
3) Basic controls
4) Beginner practice steps
5) Links to official docs
How-to Guide to implementing accessible code. Yes, if you use small examples. 1) Goal (what you’ll build)
2) Bad pattern
3) Correct code
4) Test it (keyboard + SR)
5) Common gotchas
Experience Personal story about access needs and why a11y matters. Only if you are sharing your own lived experience or have clear consent. 1) Context (short)
2) The barrier (what went wrong)
3) Impact (what it cost you)
4) What helps
5) Ask / takeaway

Want examples? Here are a few posts you can study for structure (read them as “how they teach,” not as “copy the topic”):

🧱
Example: Background-style teaching

Semantic HTML is a great “background” topic because it explains a concept and shows why it matters.

  • Notice short paragraphs.
  • Notice how examples are practical.
  • Notice how links support learning.
🧨
Example: Myth-style debunking

Myth: Automated tools can catch all issues shows the best myth format: clear claim → clear correction → actionable next steps.

  • Short, direct sentences.
  • Simple “what to do next.”
  • No shame, no drama.
Your easiest first win (if you want fast approval): write a Myth or Quick test. These formats are naturally short, beginner-first, and easy for editors to review.

Write in The A11Y Project’s style (simple rules that get “yes”)

Writing for an accessibility audience has one extra responsibility: your post must be usable by many kinds of readers. That includes people using screen readers, keyboard navigation, zoom, high contrast modes, and more. So your writing needs to be both clear and accessible.

The A11Y Project has a Content Style Guide. You should follow it closely. Below are beginner-friendly “translation rules” so you don’t overthink it.

Rule 1

Write like you’re explaining to a smart friend

Prefer short sentences. Prefer common words. Prefer active voice. Define any necessary technical term the first time you use it. If you use acronyms (WCAG, ARIA, NVDA), say what they mean once.

  • Bad: “This paradigm optimizes the operability of interactive affordances.”
  • Better: “This change makes buttons easier to use with a keyboard.”
Rule 2

Use headings that describe the content

Headings are navigation for screen reader users and keyboard users. Make headings clear and meaningful, like mini summaries.

  • Bad: “Step 2”
  • Better: “Step 2: Check keyboard focus order”
  • Better: “Fix: Use a real <button> instead of a clickable <div>”
Rule 3

Make links meaningful (no “click here”)

Links should tell the reader where they go. This helps everyone, especially screen reader users who skim link lists.

  • Bad: “Click here to read more.”
  • Better: “Read The A11Y Project Content Style Guide.”
  • Better: “W3C WAI-ARIA Authoring Practices.”
Rule 4

Show an example (bad → better) whenever possible

Accessibility is easier when readers can see the difference. In most posts, add a tiny snippet that shows the wrong pattern and the correct pattern.

  • Bad: “Don’t do low contrast.”
  • Better: “Here is a low-contrast example and a higher-contrast alternative, plus how to test it.”

Now the “extra important” part: accessibility writing should not shame people. Many readers are learning. Use a supportive tone like: “Here’s a common mistake, and here’s the fix.”

Inclusion tip: Avoid ableist language and jokes. Write about disability and assistive tech with respect. If you are unsure, keep it simple, neutral, and fact-based — and read the site’s Code of Conduct.

Research + build a tiny proof (so your post is trusted)

Accessibility advice spreads fast — and wrong advice also spreads fast. So your post must be correct. The safest way to write correct accessibility content is: test something real, then write what you did.

Below is a beginner-friendly “proof workflow.” You can do it in one afternoon. This makes your post stronger, and it also makes editors feel safe publishing your work.

🔎
Step A: Choose one real page to test

Pick any of these:

  • A page on your own site (best).
  • A simple demo page you create (HTML file is enough).
  • A public page only if you have permission to discuss it (avoid naming/shaming real brands).

Tip: Create a small local file called demo.html with one form, one nav, one button, one image. That’s enough.

🧪
Step B: Run 3 quick checks (fast + powerful)
  • Keyboard check: can you reach everything with Tab/Shift+Tab?
  • Zoom check: does it still work at 200% zoom?
  • Contrast check: can you read text easily?

You can base many posts on these checks. They also connect nicely to the site’s Checklist.

Now create your “proof notes.” This becomes your draft. Use this simple format:

Note field What you write (example) Why it helps your post
Problem “The button is a <div> and it can’t be activated by keyboard.” Gives your post a clear focus.
Impact “Keyboard-only users can’t submit the form.” Keeps the post human, not just technical.
Fix “Use a real <button> element and visible focus styling.” Shows the solution, not just the complaint.
Test “Tab reaches the button; Enter/Space activates it; focus ring is visible.” Proves your advice works.
Links “MDN button element + WAI-ARIA patterns (if needed).” Gives the reader a learning path.

Optional (but powerful): read one A11Y Project post that matches your format and copy its structure. For example, if you are writing a myth, study: Myth: Automated tools can catch all issues.

If you want lots of “what to learn next” links, open the Resources page and pick 2–4 links that directly support your post. Don’t dump 30 links. Curate the best ones.

Step-by-step submission workflow (GitHub or email)

The official process starts on the Write for Us page. The important detail is: you can contribute with GitHub or without GitHub.

This section gives you a complete beginner workflow for both paths — plus a “pitch format” that editors can review quickly.

Step 1

Choose your content type + title (one line)

Pick one of the 7 types and create a clear title. Title formula that works well:

  • Myth: “Myth: [false belief]”
  • Quick test: “Quick test: [what to check]”
  • How-to: “How to: [build/fix a specific thing]”

Example: “Quick test: check visible focus states in 3 minutes.”

Step 2

Write your pitch in a tiny “editor-friendly” format

Editors can approve faster when your pitch is structured. Use this exact format (copy/paste it into your issue or email):

  • Type: Myth / Quick tip / Quick test / How-to / Background / Assistive tech / Experience
  • Working title: (1 line)
  • Audience: “Beginners who…” (1 line)
  • Promise: “After reading, you can…” (1 line)
  • Outline: 4–7 bullet points
  • Proof: what you tested or built (1–3 lines)
  • Links: 2–5 best learning links (not 50)

Your goal is to make it easy for the editor to say: “Yes, this fits.”

Step 3A

If you have GitHub: submit an Issue

The Write for Us page says GitHub contributors should submit an issue with a clear subject line. Start here: a11yproject/a11yproject.com Issues.

  • Click “New issue.”
  • Use a clear title (example: “New myth post about automated testing”).
  • Paste your pitch format from Step 2.
  • Attach or link to your draft (Google Docs is fine).

Bonus: If you want easier starter tasks, check “Good First Issue”: Good First Issue label.

Step 3B

If you don’t have GitHub: pitch by email

If you prefer not to use GitHub, you can contact them as described on the Write for Us page. In your email, include:

  • Your pitch format (Step 2).
  • A link to your draft in a commentable format (Google Docs / Dropbox Paper / etc.).
  • A short 2–3 line bio (relevant experience only).

Tip: Put your content type in the subject line, like: “Pitch: Quick test — keyboard navigation basics.”

Step 4

Expect editing (and treat it as professional training)

Editors will review your post and suggest changes. This is normal. Don’t take edits personally. The goal is: publish a post that is correct and helpful.

  • Answer questions clearly.
  • Fix any unclear language.
  • Re-test steps if needed.
  • Keep your tone supportive and calm.

When the editor is satisfied, your post is published and you are notified.

Don’t skip this: read the Contributing Guidelines before you submit. It includes rules about what they won’t publish and how to contribute safely.

Money + career plan (beyond the $75)

The A11Y Project pays per published post (great), but you should think bigger than one payment. Accessibility writing is a skill that can turn into a steady income stream.

Here is a simple beginner money ladder (start small → earn more):

🪜
Stage 1: one post + one expanded version
  • Publish one short post on The A11Y Project.
  • Write an expanded version on your own blog (more examples, more screenshots).
  • Use internal links to your related posts to build a small accessibility content hub.

Result: you now have one strong clip and one “home base” article you own.

📣
Stage 2: pitch paid guest posts (with proof)
  • Pitch the same topic to other publications as a different angle (case study, checklist, opinion).
  • Use your A11Y Project post as proof that you can write clearly about a11y.
  • Offer a specific promise: what the reader can do after reading.

Result: higher paid assignments become easier because editors trust you.

Then move to “productized” income (this is where many accessibility writers earn more):

Income stream What you offer How your A11Y Project post helps
Accessibility audits Quick checks + report + prioritized fixes Your post shows you understand basics and communicate clearly
Training workshops Teach teams keyboard testing, semantics, forms, etc. Your post becomes the “preview” of your teaching style
Retainer writing Monthly a11y articles for a company blog Clips remove doubt (“They can write this topic well.”)
UX + content consulting Fix forms, nav, error messages, headings, alt text Your post proves practical, real-world ability

A simple monthly plan (beginner-friendly):

Month plan

Publish 1 + pitch 3 + sell 1

  • Publish 1: One short A11Y Project post (myth or test).
  • Pitch 3: Three related guest post ideas to other sites.
  • Sell 1: One small service offer (audit, workshop, or a11y content review).

Repeat for 3 months. Your portfolio grows fast, and your confidence grows faster.

Important: If you mention tools in your writing, do it because they help readers — not to push affiliate links. The A11Y Project is careful about promotions and referral schemes.

Ethics, AI, inclusion, and “do no harm” writing

Accessibility content affects real people. If your post is wrong, it can create barriers. If your tone is careless, it can make readers feel unwelcome. So this is the section many writers skip — but it’s the section that makes you professional.

🙅
What to avoid (common beginner mistakes)
  • Don’t shame: “Only idiots use div buttons.” (No.) Teach the fix instead.
  • Don’t stereotype: avoid “all blind people…” or “disabled users always…”
  • Don’t invent: no fake “I tested this on 20 users” stories.
  • Don’t promote: avoid spammy links, referral schemes, backlink deals.
  • Don’t copy: rewrite in your own words and credit sources properly.
🤝
Safe AI use (if you use AI at all)

AI can help with outlining and clarity — but it can also hallucinate technical details. If you use AI, use it like an assistant, not like an author.

  • Use AI to propose headings or a draft outline.
  • Then rewrite fully in your own voice.
  • Test every code snippet yourself.
  • Verify every claim with a reliable source (W3C / MDN / reputable orgs).

Your name is on the post. You are responsible for correctness.

Also: follow community rules. Read and respect the Code of Conduct and the site’s Accessibility Statement.

Golden rule: write so that a reader can apply your advice without buying anything, without joining a course, and without being “talked down to.” Teach clearly. Test honestly. Link responsibly.

Final pre-submit checklist (use this every time)

This checklist turns your writing into a repeatable system. If you follow it, you will submit better work with less stress.

Bonus confidence trick: before you submit, read your post out loud. If you stumble, simplify that sentence.

FAQ for beginners + the best learning links (a lot of them)

Can a complete beginner write for The A11Y Project?
Yes — if you keep the post small and practical. Start with a “Myth” or a “Quick test.” Avoid deep technical essays. Use the templates in this guide, follow the Content Style Guide, and submit a clear pitch.
Do I need to be an accessibility professional?
You don’t need a job title. You need honesty, testing, and respectful writing. If you tested your advice and you can explain it clearly, you can contribute. If you are unsure, pitch a smaller topic or ask questions in your submission thread.
Should I submit a full draft or just an idea?
Either can work, but a strong beginner approach is: pitch a structured outline first (type, promise, bullets). Then write a full draft once the editor says “yes” or gives direction. If you already wrote a draft, share it in a commentable format (Google Docs, Dropbox Paper, etc.).
How do I get more topic ideas?
Use three sources: the Posts archive, the Checklist, and the GitHub List of Post Ideas. Then combine: pick one checklist item and explain a quick test for it.
What’s the fastest first post you recommend?
Write a myth or quick test that you can personally verify in one afternoon. Example: “Quick test: check keyboard focus visibility.” Keep it short. Add a small fix section.
How do I turn one A11Y Project post into more paid writing?
Turn the same topic into three angles: 1) a case study (“how I fixed…”), 2) a checklist (“10 checks…”), 3) an opinion (“why this myth is harmful…”). Use your A11Y Project byline as proof and pitch other publications.
Next steps (simple): choose one content type, write a 6-bullet outline, test one thing, then submit. If you want to keep learning daily, use the Checklist as a “topic generator” — one checklist item = one possible myth, tip, test, or how-to.
This HTML block uses your Favourite1-style white layout with simple language, adapted as a mini-course for writing and earning with The A11Y Project. You can edit the copy, links, tables, and icons for your own course, SOP, or lead magnet.

Leave a Comment

Your email address will not be published. Required fields are marked *

Shopping Cart
Scroll to Top