본문으로 이동
좋은 에러 메시지를 만드는 6가지 원칙
문서

좋은 에러 메시지를 만드는 6가지 원칙

김자유 토스 · 토스 기술 블로그

원문 보기

AI 핵심 요약

토스는 원인을 알 수 없고 해결 방법도 제시하지 않는 에러 메시지가 사용자를 막막하게 하고 제품에 대한 인상까지 해칠 수 있다고 봤다. 메시지의 핵심 가치를 사용자가 다음 단계로 나아가도록 돕는 ‘Navigating’으로 정하고, 상황·이유·해결책을 전달하는 여섯 가지 원칙을 세웠다. 에러를 없앨 수 있는지 먼저 살피고, 상황에 맞는 컴포넌트를 고른 뒤 사용자 언어로 해결 방법을 안내하며, 버튼 등으로 실행을 쉽게 하고 부정적인 감정을 배려했다. 에러 문구를 작성할 때는 이 원칙들을 체크리스트로 활용해 사용자가 스스로 문제를 해결할 수 있는지 점검하라고 제안한다.

  • 문구를 다듬기 전에 화면 흐름을 바꿔 에러 자체를 없앨 수 있는지 확인하세요.
  • 설명이 필요한 내용은 토스트보다 다이얼로그처럼 충분히 읽을 수 있는 컴포넌트에 담으세요.
  • 시스템 내부의 예외나 업계 용어를 사용자 관점의 원인과 행동으로 바꿔 표현하세요.
  • 해결책을 안내하는 데 그치지 말고, 버튼이나 바로가기 등으로 실행에 드는 수고를 줄이세요.
  • 부정형·강요형 표현 대신 사용자가 할 수 있는 선택지를 제시해 좌절감을 덜어주세요.

소개

좋은 에러 메시지란, 사용자가 다음 단계로 갈 수 있게 돕는 메시지예요. 사용자가 다음 단계로 가기 위해 필요한 내용은 어떤 것들이 있을까요? 토스는 6가지 에러 메시지 원칙을 생각하며 문구를 쓰고 있어요.

비슷한 학습 자료

문서 강민우

'접근성은 어려운 것' 이라고 느끼는 분들을 위해 실무에서 바로 적용할 수 있는 접근성의 핵심 개념과 실수하기 쉬운 패턴을 알려주는 문서, A11y Fundamentals 을 소개합니다.

UI/UX

문서 유아란

자극적인 표현 없이 클릭률 높은 문구를 쓸 수 있을까요? 수백 번의 테스트를 통해 찾아낸 토스의 마케팅 문구 원칙 6가지를 소개합니다.

프로덕트 지표 · 실험

문서 이혜인

토스의 제품 디자인 원칙 중에는 Value first, cost later라는 항목이 있어요. 비용을 말하기 전에 가치를 명확하게 전달해야한다는 내용이에요. 가치를 먼저 보여주는 것 만으로도 지표를 눈에 띄게 개선한 사례를 소개해드릴게요.

UI/UX 프로덕트 지표 · 실험

문서 김재현

토스에는 좋은 제품을 만들기 위한 디자인 원칙들이 있어요. 오늘은 그 중에 easy to answer라는 항목을 적용해서 제품을 개선한 사례를 소개해드릴게요.

UI/UX

문서 김자유

토스의 문구는 8가지 라이팅 원칙을 고려하면서 쓰고 있어요. 사람이 말하는 것 같은 문장을 지향하면서요.

UI/UX

문서 김자유

UX 라이팅은 한 명이 아닌, 팀원 모두가 잘 쓰는 게 중요해요. 이전까지는 세션이나 가이드라인 등의 방법으로 이 문제를 접근해왔지만, 토스는 조금 다르게 풀어봤어요. 시스템으로요.

UI/UX