diff --git a/articles/modeling/grouping-tagging.md b/articles/modeling/grouping-tagging.md index 9a3f42b..db70098 100644 --- a/articles/modeling/grouping-tagging.md +++ b/articles/modeling/grouping-tagging.md @@ -2,14 +2,17 @@ ![Tagging and Grouping Endpoints](https://github.com/stoplightio/docs/blob/develop/assets/gifs/modeling-tagging.gif?raw=true) -## What -You can define tags in the Modeling editor to group endpoint for an additional layer of organization. +## What -> Tagged endpoints also affects how the endpoints are displayed in Hubs. The tag will be rendered as a header, and the endpoints will be grouped underneath it +Use tags to group API endpoints and provide an additional layer of organization in your OpenAPI files. + +When rendering your OpenAPI in read view, Stoplight will group API endpoints by their first tag. + +## How -## How 1. Click **Tag** in the top Modeling toolbar 2. Input a **Name** 3. Input a **Tag description** (optional) 4. Select the endpoint you want to tag -5. Select the tag you created under **tags** +5. Open the **tags** dropdown, and select the tag that you just created +6. Switch to read view and you should see the endpoint grouped under that tag in the sidebar