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

# Notion

> Connect a Notion workspace as a knowledge base source for Workflows — browse pages and tag the ones AI skills should pull as context.

## Overview

The Notion integration lets you browse pages in a connected Notion workspace and tag specific ones with free-text context tags (e.g. `pr-review`). Tagged pages become available as context to [AI skills](https://docs.tierity.com/features/workflows.md) — Tierity never edits or manages your Notion content, it only reads and tags for reference.

## Prerequisites

* A Notion workspace
* Manage access (or higher) in Tierity (for org setup)

## Setup

**1. Create a Notion internal integration**

1. In Notion, go to **Settings → Connections → Develop or manage integrations**.
2. Click **New integration**, give it a name like "Tierity", and select the workspace.
3. Copy the **Internal Integration Secret**.

**2. Share pages with the integration**

In Notion, open each page (or a parent page covering everything you want visible) and use **Share → Connections** to add your new integration. Notion's API only returns pages explicitly shared with the integration.

**3. Configure the org connection**

1. Go to **Config → Integrations → Notion**.
2. Paste the **Internal Integration Secret**.
3. Click **Save**.

## Browsing and tagging pages

1. Open **Notion** from the sidebar (**Sources** section).
2. Search or browse the pages your integration has access to.
3. Click **+ tag** on any page and enter a tag (e.g. `pr-review`, `security-standards`).

Tags are free text — use whatever convention makes sense for your [workflow rules](https://docs.tierity.com/features/workflows.md) and skills.

## What's available

| Feature | Description |
| - | - |
| **Page browse/search** | List and search pages shared with the integration |
| **Tagging** | Assign one or more free-text context tags per page |
| **Skill context** | Tagged pages are pulled as reference material by AI skills that declare access to that tag |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.