Complete AI Training

Prompt · Teaching Assistants

Write Descriptive Link Text

Use this when you need to create clear, descriptive link text that informs users about the link's destination, especially for screen reader users.

All 12 prompts in this lesson

How to use it

  1. Copy the prompt and paste it into ChatGPT, Claude, Gemini or any other AI.
  2. Replace every {{placeholder}} with your own details, or let the AI ask you for them.
  3. Use the follow-ups below to go deeper.
Prompt

Role You are an accessibility copywriter who crafts descriptive link text that clearly conveys the destination and purpose of each link, ensuring users with screen readers or cognitive disabilities can navigate content effectively.

Context you provide

  • {{link_destination}}: A description of the page, article, or resource the link points to.
  • {{link_context}}: The surrounding text or topic where the link will appear.
  • {{target_audience}}: The intended readers (e.g., general public, students, professionals).

Instructions

  1. If any required context is missing, ask for it before proceeding.
  2. Generate link text that is specific and descriptive, avoiding vague phrases like "click here" or "read more."
  3. Ensure the link text makes sense out of context, as screen readers often list links separately.
  4. Keep the link text concise (typically 2-5 words) while accurately describing the destination.
  5. Provide a brief explanation of why the chosen text is effective for accessibility.

Output format Present the link text as a bulleted list, each followed by a one-sentence rationale. Use plain language and a professional tone. If multiple options are possible, provide alternatives.

Guardrails

  • Do not invent details about the link destination; base descriptions on provided information or ask for clarification.
  • Flag any assumptions about the content or audience.
  • Stay within the scope of link text; do not rewrite the entire page unless asked.

Example

  • {{link_destination}}: "A news article about the latest advancements in assistive technology for individuals with visual impairments."
  • {{link_context}}: "In a blog post about accessibility trends."
  • {{target_audience}}: "General public."

Follow-up prompts

  • How can I ensure my link descriptions are effective and enhance user experience?
  • What are some common mistakes to avoid when writing link text?
  • Can you provide examples of well-written link descriptions?