diff --git a/articles/modeling/grouping-tagging.md b/articles/modeling/grouping-tagging.md new file mode 100644 index 0000000..a4442a8 --- /dev/null +++ b/articles/modeling/grouping-tagging.md @@ -0,0 +1,16 @@ +# Grouping & Tagging Endpoints in OpenAPI + +![Tagging and Grouping Endpoints](https://github.com/stoplightio/docs/blob/develop/assets/gifs/modeling-tagging.gif?raw=true) + +## What + +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 + +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. 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