> 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).

# 주요 기능 등록하기

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

{% hint style="info" %}
**꼭 확인하세요**

* 주요 기능은 최소 1개 이상 등록해야 해요.
* 검토에는 영업일 기준 1\~2일이 소요될 수 있어요.
  {% endhint %}

<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>

***

### 주요 기능 등록하기

미니앱을 최초로 출시하는 경우에는 번들 검토를 요청할 때 주요 기능을 함께 등록할 수 있어요.

* **접속방법 :** 앱인토스 콘솔 → 워크스페이스 선택 → 미니앱 선택 → 좌측 메뉴 ‘앱 출시’→ 미니앱 선택 → 좌측 메뉴 ‘앱 출시’ → ‘+ 등록하기 ‘ → ait 번들 업로드 후 입력 가능

**1. 앱 출시 메뉴에서 ‘등록하기’ 를 눌러서 번들을 등록해 주세요.**

<figure><img src="https://4036587353-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fsueslih0uoBKTKHdmDNt%2Fuploads%2FsaogD9Vp249rSVdn71FR%2Fimage.png?alt=media&#x26;token=12d67940-8ae9-42a4-b94e-e205d702e32e" alt=""><figcaption></figcaption></figure>

**2. 빌드한 ait 파일을 업로드 해주세요.**

<figure><img src="https://4036587353-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fsueslih0uoBKTKHdmDNt%2Fuploads%2FflyeBo2Lt3uvUh2I4WRp%2Fimage.png?alt=media&#x26;token=e62ebd9a-9a58-44a2-a261-38220ba709ca" alt=""><figcaption></figcaption></figure>

**3. 번들 검토를 요청할 때 주요 기능을 함께 등록해 주세요.**

<figure><img src="https://4036587353-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fsueslih0uoBKTKHdmDNt%2Fuploads%2FIBorigDraqzr0txaxGh0%2Fimage.png?alt=media&#x26;token=e73881e7-f5d0-4d0e-b1a2-03e12ff7d2b0" alt=""><figcaption></figcaption></figure>

* 실제 미니앱 출시 시, 설정한 주요 기능도 함께 출시돼요.
  * 출시 검토 시점에 주요 기능 URL이 정상 접속되지 않으면 반려될 수 있어요.
  * 출시 후에도 기능이 정상 동작하는지 꼭 확인해 주세요.
* 주요 기능은 ‘한국어 기능 이름’과 ‘영어 기능 이름’을 함께 입력해야 해요.

  | 구분        | 규칙                                                                                                                     |
  | --------- | ---------------------------------------------------------------------------------------------------------------------- |
  | 한국어 기능 이름 | <p>• 특수문자는 <code>:</code>, <code>.</code>만 허용돼요.<br>• 이모지는 사용이 불가해요.<br>• 글자 수는 10자 이내로 입력해요.</p>                      |
  | 영어 기능 이름  | <p>• 특수문자는 <code>:</code>, <code>.</code>만 허용돼요.<br>• 이모지는 사용이 불가해요.<br>• 글자 수는 15자 이내로 입력해요.<br>• 첫글자만 대문자로 입력해요.</p> |
* 사용자가 바로 접속할 수 있는 기능의 이름과 이동할 **intoss\://pages** 를 입력해 주세요.
  * 쿼리 파라미터를 설정할 수 있어요.
* 토스 UX 라이팅을 기반으로 주요 기능은 **‘\~하기’** 또는 **‘명사형’** 으로 작성해 주세요.
  * 예) ‘송금 내역 확인하기’, ‘해외 송금하기’, ‘여행 예약 내역 확인하기’ 등
* 미니앱 서비스의 기능이 드러나게 작성해 주세요.
  * ‘예약 확인하기’, ‘내역 확인’, ‘보러가기’, ‘시청하기’ 등으로만 작성할 경우 무슨 서비스의 기능인지 사용자가 알기 어려워요.

**4. 검토 결과는 ‘주요 기능’ 탭에서 확인할 수 있어요.**

* ‘주요 기능’ 탭에서 주요 기능만 따로 등록/수정을 할 수 있어요.
* 주요 기능만 따로 추가/수정하는 경우는 주요 기능만 검토하기 때문에 영업일 기준 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>

***

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

**1. Webview**

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

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

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

**2. 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.