> For the complete documentation index, see [llms.txt](https://developers-apps-in-toss.toss.im/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developers-apps-in-toss.toss.im/guide/operation/function.md).

# 주요 기능 등록하기

주요 기능은 사용자가 비게임 미니앱 상세에서 특정 기능으로 바로 들어올 수 있게 해주는 기능이에요. 홈 화면을 거치지 않고 원하는 세부 기능으로 바로 이동해요.

<figure><img src="https://4036587353-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fsueslih0uoBKTKHdmDNt%2Fuploads%2FN3pIHX8o5UGrsc93anOL%2Fimage.png?alt=media&#x26;token=6db8f8b2-504e-4329-98fa-65549eba00d2" alt=""><figcaption></figcaption></figure>

***

### 콘솔에서 등록하기

#### 1. 앱 출시 메뉴의 '주요 기능' 탭 들어가기

<figure><img src="https://3177177630-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8pQgXiR5QAzduV54W8Om%2Fuploads%2FmYI7X5WRhvRsoEApEey7%2F%E1%84%80%E1%85%A5%E1%86%B7%E1%84%90%E1%85%A9%20%E1%84%8C%E1%85%AE%E1%86%BC%2035.png?alt=media&amp;token=5dbfade3-0ba0-4d4b-81f7-5e47826227e2" alt=""><figcaption></figcaption></figure>

#### 2. 주요 기능 입력하기

주요 기능은 최대 3개까지 등록할 수 있어요.

<figure><img src="https://3177177630-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8pQgXiR5QAzduV54W8Om%2Fuploads%2FpOFz0iZMRz7H9QF6GWx2%2F%F0%9F%9F%A3%20Desktop_Modal%20(New%20Color)%2080.png?alt=media&amp;token=362879bc-bcb2-444d-b705-8d54ca4f381d" alt=""><figcaption></figcaption></figure>

**주요 기능은 '한국어 기능 이름'과 '영어 기능 이름'을 함께 입력해야 해요.**

* **한국어 기능 이름:** 10자 이내, 특수문자는 `:` `.` 만 허용, 이모지 사용 불가
* **영어 기능 이름:** 15자 이내, 첫 글자만 대문자, 특수문자는 `:` `.` 만 허용, 이모지 사용 불가

기능 이름은 토스 UX 라이팅에 따라 '\~하기'나 명사형으로 작성해 주세요.

* 예) '송금 내역 확인하기', '해외 송금하기', '여행 예약 내역 확인하기'
* 미니앱 서비스의 기능이 드러나게 작성해 주세요. '예약 확인하기', '내역 확인', '보러가기', '시청하기'처럼만 쓰면, 무슨 서비스의 기능인지 사용자가 알기 어려워요.

**사용자가 바로 접속할 기능 이름과 이동할 `intoss://pages` 주소를 입력해 주세요.**

* 주요 기능 URL에 정상 접속되지 않으면 반려될 수 있어요.
* 쿼리 파라미터를 설정할 수 있어요.

모두 입력했다면 '검토 요청하기'를 눌러주세요. 검토에는 영업일 기준 1\~2일이 걸릴 수 있어요.

***

### 주요 기능 정보 확인하기

검토 결과는 '주요 기능' 탭에서 확인할 수 있어요.

* '주요 기능' 탭에서 주요 기능만 따로 등록하거나 수정할 수 있어요.
* 주요 기능만 따로 추가·수정하면 주요 기능만 검토하기 때문에, 영업일 기준 1\~2일이 걸릴 수 있어요.
* 이미 운영 중인 미니앱에서 새로 추가하거나 수정할 때도, 주요 기능에 정상 접속되는지 꼭 확인해 주세요.

<figure><img src="https://4036587353-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fsueslih0uoBKTKHdmDNt%2Fuploads%2FniQbAEzUpb1jG5p7V2yl%2Fimage.png?alt=media&#x26;token=699de974-b97c-4fb4-b5fc-27c90b7caa9b" alt=""><figcaption></figcaption></figure>

***

### 개발 환경별 피처 구성

#### Webview

라우터 경로를 피처 주소와 매핑해요.

```
<Route path="/search" element={<SearchPage />} />
```

피처 주소를 `intoss://{appName}/search`로 입력하면 해당 페이지로 이동할 수 있어요.

#### React Native

Next.js와 비슷한 파일 기반 라우팅을 써요.

`/pages/search.tsx` → `/search` 경로 매핑 → `intoss://{appName}/search`로 진입 시 렌더링

자세한 구조는 [파일 기반 라우팅 이해하기](https://appsintoss.gitbook.io/appsintoss-docs/documentation/react-native/screen-navigation/navigation)를 참고하세요.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://developers-apps-in-toss.toss.im/guide/operation/function.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
