> ## Documentation Index
> Fetch the complete documentation index at: https://getsteps.app/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# 위젯

> 홈 화면, 잠금 화면, 라이브 액티비티 위젯으로 한눈에 걸음 수를 확인하세요

Steps는 앱을 열지 않고도 걸음 수, 연속 달성, 운동 데이터를 확인할 수 있는 다양한 위젯을 제공합니다.

## 위젯 유형

<Frame caption="홈 화면의 Steps 위젯">
  <img src="https://mintcdn.com/steps-9a9e4b74/WCAWzedZyITaHflp/images/screenshots/widgets-home-screen.jpg?fit=max&auto=format&n=WCAWzedZyITaHflp&q=85&s=226c756614d6ca827808e828f0aed63e" alt="홈 화면 위젯" width="2131" height="1598" data-path="images/screenshots/widgets-home-screen.jpg" />
</Frame>

| 위젯 | 크기 | 설명 |
| - | - | - |
| **오늘의 걸음 수** | 소형, 잠금 화면 (직사각형, 인라인, 원형) | 현재 걸음 수와 목표 진행 상황 |
| **월간 캘린더** | 중형 | 해당 월의 일일 목표 달성을 보여주는 캘린더 그리드 |
| **연간 캘린더** | 중형, 대형 | 목표 달성 히트맵이 있는 한 해 한눈에 보기 캘린더 |
| **연간 목표** | 소형, 중형 | 상태와 통계가 포함된 연간 걸음 수 목표 진행 상황 |
| **시간별 차트** | 중형 | 오늘의 시간별 걸음 수 막대 차트 |
| **주간 차트** | 중형 | 최근 7일간의 걸음 수 막대 차트 |
| **월간 차트** | 중형 | 이번 달의 걸음 수 막대 차트 |
| **연속 달성** | 소형, 중형 | 현재 연속 달성 횟수와 주간 목표 진행 |
| **운동 하이라이트** | 소형 | 가장 최근 운동 통계 |
| **스텝보드 순위** | 소형 | 오늘의 리더보드 상위 5명과 내 순위 |
| **운동 시작** | 소형, 중형 | 한 번의 탭으로 운동 유형에 바로 진입 |
| **운동 캘린더** | 중형, 대형, 특대 | 그날의 활동으로 표시된 운동한 날 |

## 스텝보드 순위 위젯

<Frame caption="오늘의 상위 5명과 내 순위를 보여주는 스텝보드 순위 위젯">
  <img src="https://mintcdn.com/steps-9a9e4b74/cPpuVRCxrX6EoK3O/images/screenshots/widgets-stepboard-ranking.jpg?fit=max&auto=format&n=cPpuVRCxrX6EoK3O&q=85&s=ba88c4b060465c135e225a662f0d1aa2" alt="Stepboard Ranking widget" width="2218" height="1664" data-path="images/screenshots/widgets-stepboard-ranking.jpg" />
</Frame>

스텝보드 순위 위젯은 [스텝보드](/docs/features/stepboard)를 홈 화면에 표시합니다. 선두에게는 메달 이모지와 함께 오늘의 상위 5명 걷기 참가자를 보여주며, 상위 5명 밖에 있는 경우 내 순위도 표시합니다. 위젯을 추가할 때 표시할 보드—World 보드 또는 참가한 그룹—를 선택할 수 있습니다. 위젯을 탭하면 해당 보드로 바로 이동합니다.

## 운동 시작 위젯

<Frame caption="한 번의 탭으로 운동을 추적하는 운동 시작 위젯">
  <img src="https://mintcdn.com/steps-9a9e4b74/cPpuVRCxrX6EoK3O/images/screenshots/widgets-start-workout.jpg?fit=max&auto=format&n=cPpuVRCxrX6EoK3O&q=85&s=76a4243fea4f0ee15a95cddd7b3a0fe2" alt="Start Workout widget" width="2218" height="1664" data-path="images/screenshots/widgets-start-workout.jpg" />
</Frame>

운동 시작 위젯을 사용하면 홈 화면에서 바로 [운동](/docs/features/workout-session) 추적을 시작할 수 있습니다. 탭하면 Steps가 해당 운동 유형으로 바로 열려 메뉴를 찾아 들어갈 필요가 없습니다.

* **소형** — 시작 버튼이 있는 구성 가능한 단일 운동 유형
* **중형** — 주 운동과 함께 세 가지 추가 유형의 빠른 시작 단축키

위젯을 추가할 때 시작할 운동 유형을 선택하세요. 앱에서 시작할 수 있는 것과 같은 유형을 사용할 수 있으며, 근력 운동, HIIT, 요가와 [운동 목록](/docs/features/workout-session#workout-types)의 나머지 유형이 포함됩니다. 운동이 이미 진행 중인 경우, 위젯을 탭하면 대신 진행 중인 세션이 열립니다.

## 운동 캘린더 위젯

운동 캘린더 위젯은 운동한 각 날을 그날의 활동으로 표시하여, 한 달의 달리기·걷기·근력 운동을 한눈에 볼 수 있습니다.

* **중형**과 **대형**은 지원되는 모든 iPhone에서 사용 가능합니다
* **특대**는 iOS 27에서 사용 가능합니다

<Note>운동 캘린더 위젯은 Pro 기능입니다.</Note>

## 연간 목표 위젯

연간 목표 위젯은 [연간 걸음 수 목표](/docs/features/yearly-goal)를 향한 진행 상황을 추적합니다. 진행 바, 정상 진행 또는 뒤처짐 여부, 보조 통계를 표시합니다. 소형 및 중형 크기로 사용할 수 있습니다.

## 라이브 액티비티

활성 운동 중에는 잠금 화면과 다이나믹 아일랜드(iOS 26+)에 라이브 액티비티가 나타납니다. 표시 내용:

* 운동 유형 아이콘
* 경과 시간
* 이동 거리
* 소모 칼로리
* 현재 페이스

다이나믹 아일랜드는 30초마다 통계를 순환 표시합니다. iOS 27에서는 활성 운동이 landscape Dynamic Island와 StandBy에도 표시됩니다.

## 위젯 추가하기

<Steps>
  <Step title="홈 화면 길게 누르기">
    홈 화면의 빈 곳을 앱이 흔들릴 때까지 길게 터치하세요.
  </Step>

  <Step title="+ 버튼 탭">
    왼쪽 상단의 **+** 버튼을 탭하여 위젯 갤러리를 여세요.
  </Step>

  <Step title="Steps 검색">
    검색 바에 "Steps"를 입력하여 사용 가능한 모든 위젯을 찾으세요.
  </Step>

  <Step title="위젯 선택">
    원하는 위젯 유형과 크기를 선택한 다음 **위젯 추가**를 탭하세요.
  </Step>
</Steps>

## 잠금 화면 위젯

<Frame caption="세 가지 스타일의 Steps 잠금 화면 위젯">
  <img src="https://mintcdn.com/steps-9a9e4b74/WCAWzedZyITaHflp/images/screenshots/widgets-lock-screen.jpg?fit=max&auto=format&n=WCAWzedZyITaHflp&q=85&s=cc92b4374665650aeaafe5cc10dea664" alt="잠금 화면 위젯" width="1920" height="1080" data-path="images/screenshots/widgets-lock-screen.jpg" />
</Frame>

오늘의 걸음 수 위젯은 잠금 화면에서도 세 가지 스타일로 사용 가능합니다:

* **직사각형** - 걸음 수와 진행 바 표시
* **인라인** - 날짜 줄의 컴팩트한 걸음 수
* **원형** - 둥근 게이지 안의 걸음 수

<Tip>위젯은 최신 걸음 수 데이터로 자동 업데이트되며 선택한 색상 테마를 반영합니다.</Tip>

## 위젯 최신 상태 유지

위젯이 최신 걸음 수 데이터로 자주 새로고침되려면 Steps의 **백그라운드 앱 새로고침**이 활성화되어 있어야 합니다.

<Steps>
  <Step title="설정 열기">
    **설정 → 일반 → 백그라운드 앱 새로고침**으로 이동하세요.
  </Step>

  <Step title="백그라운드 앱 새로고침 활성화">
    마스터 토글이 **Wi-Fi 및 셀룰러 데이터** (또는 최소한 **Wi-Fi**)로 설정되어 있는지 확인하세요.
  </Step>

  <Step title="Steps 활성화">
    아래로 스크롤하여 **Steps** 옆의 토글이 켜져 있는지 확인하세요.
  </Step>
</Steps>

<Warning>백그라운드 앱 새로고침이 비활성화되면 위젯에 오래된 걸음 수가 표시되고 앱을 열 때만 업데이트됩니다.</Warning>