> For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://docs.ada.cx/llms.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.ada.cx/_mcp/server. # Article management ## Overview Article management lets you control which Knowledge articles your AI Agent can use when creating responses. After you've imported your articles, they appear on the **Knowledge** page, sorted so the articles that were most recently updated in your knowledge base appear first. ## Use cases Article management helps you curate your AI Agent's knowledge to improve response quality. * **Exclude outdated content**: Disable articles that contain outdated information until they are updated in your knowledge base. * **Control sensitive information**: Restrict certain articles to specific end users based on variables like region or account type. * **Test new content**: Disable new articles initially, then enable them after verifying they produce appropriate responses. * **Seasonal or promotional content**: Activate or deactivate articles for time-limited campaigns or events. ## Capabilities & configuration Article management provides the following controls: * **Active/inactive status**: Enable or disable individual articles or bulk-select multiple articles at once. * **Availability rules**: Restrict articles to specific end users based on variable conditions. * **Search and filter**: Find articles by name, status, source, language, or custom tags. * **Pagination**: Navigate through large article lists with customizable page sizes. ## Quick start Control article availability in a few steps. **To enable or disable articles:** Go to **Config > AI AGENT > Knowledge**. Select the check boxes beside the articles you want to change. Click **Set as active** or **Set as inactive**. For more options, see [Enable or disable articles](#enable-disable-articles). ## Implementation & usage Manage article status, availability, and filtering to control how your AI Agent uses Knowledge content. ### Enable or disable articles\[#enable-disable-articles] Control whether your AI Agent can create content from individual Knowledge articles. By default, when you connect your knowledge base to Ada, all articles are active, which means your AI Agent can create responses from them. **To enable or disable articles:** 1. On the Ada dashboard, go to **Config > AI AGENT > Knowledge**. 2. Change settings for articles one by one, or select the articles you want to include or exclude all at once. If you want to see any of your articles in more detail, you can click an article's name to open it in a new tab. * To include or exclude an individual article from your AI Agent's response content, toggle the **Active** setting beside it. * To change article status in bulk, select the relevant check boxes to the left of the article name. To find articles, you can enter search terms in the **Search by article name** field, or click the **Filter** list to filter articles by: * Whether the articles are currently active * The source they came from * The language they're in * Any custom [article tags](https://developers.ada.cx/reference/tags-knowledge-api) you associated with them using the Knowledge API Then, you can select articles from your results. At the bottom of the list of articles, you can also change how many articles to display at a time, or move between pages. Even if you scroll through different pages onscreen, the dashboard remembers the articles you've already selected. 3. At the bottom of the page, click either **Set as inactive** or **Set as active**. Your AI Agent immediately adds or removes your selected articles from the content it can use to generate responses. ### Restrict article availability\[#article-rules] Limit which end users can access specific Knowledge articles based on variable values. You can restrict Ada articles to certain end users based on information your AI Agent collects and saves in variables. > **Note** > > You can only use variables your AI Agent can collect through your browser, or that you collect in a block and allow to be available outside of the structured content the block is in. You can't use variables your AI Agent collects using Actions. **To restrict article availability:** 1. On the Ada dashboard, go to **Config > AI AGENT > Knowledge**. 2. Select the articles you want to change the availability for. To find articles, you can enter search terms in the **Search by article name** field, or click the **Filter** list to filter articles by: * Whether the articles are currently active * The source they came from * The language they're in * Any custom [article tags](https://developers.ada.cx/reference/tags-knowledge-api) you associated with them using the Knowledge API Then, you can select articles from your results. At the bottom of the list of articles, you can also change how many articles to display at a time, or move between pages. Even if you scroll through different pages onscreen, the dashboard remembers the articles you've already selected. 3. Click **Set availability**. The Set availability window opens. * To restrict the article to certain end users, select **Based on the following rules**. * A section expands where you can enter the logic your AI Agent will use to decide whether to serve the article. 1. Under **Where**, in the **Choose a variable** list, select a variable. 2. In the next dropdown, select an operator so you can define a relationship between the variable and the value you want to target. #### Understand comparison operators Comparison operators are logic statements that tell your AI Agent to match end user information that's captured in the variable you're using. The available operators vary based on the variable type you're using: | **Operator** | **Variable types** | **Description** | | :---------------------------------------------------------------------------------------------------------------------- | :----------------------------------------------------------------------------------- | :----------------------------------------------------------------------------------------------- | | ![Begins With icon](/_fern-img/e8b9c807586a4238654793da51b49ec15e7045c0691d461567178070e57a1840.webp) **Begins With** | - All text variables (including phone and email) | Match information in the variable that begins with certain text (partial match). | | ![Ends With icon](/_fern-img/9bc404d3db5ea684a901bf8426485894bb62abb8369e498b98dc4e4f3807a5ec.webp) **Ends With** | - All text variables (including phone and email) | Match information in the variable that ends with certain text (partial match). | | ![Contains icon](/_fern-img/a4f0225811b1ecde2f125de907c2ad1b084268805cd89a00f465649ddbf8eaa2.webp) **Contains** | - All text variables (including phone and email)- List variables | Match information in the variable that contains certain text in any position (partial match). | | ![Is icon](/_fern-img/7266dedcf2da1af5c496469379bd4fb68d5e65492c190e9567c75edbbbf7e260.webp) **Is** | - All text variables (including phone and email) - Number variables | Match information in the variable that equals specific text exactly (exact match). | | ![Is Not icon](/_fern-img/d94952ab65e9f266413c582390a1d702ebb32c7a2023709ee96741b6df1b17e4.webp) **Is Not** | - All text variables (including phone and email) - Number variables | Match information in the variable that does not equal specific text exactly (exact match). | | ![Is Not Set icon](/_fern-img/283cad3d89c7d92f279d722592cd958630a40527266a47d316ab3b3b2051b71f.webp) **Is Not Set** | - All text variables (including phone and email) - Number variables - List variables | Match if there is no information contained in the variable. | | ![Is Set icon](/_fern-img/8c1019797a0482018682d52622c9e2fe56ddc5aef8925dc3e3db678c121c6869.webp) **Is Set** | - All text variables (including phone and email) - Number variables - List variables | Match if there is any information contained in the variable. | | ![Greater Than icon](/_fern-img/45636711dfe933087353da3923c6865b6816ea671ad6e9db4739aeea4c80a697.webp) **Greater Than** | - Number variables | Match if the information in the variable is greater than a specific value. | | ![Less Than icon](/_fern-img/f2448b33a8931270e63ea8daab74e67ade1fdfdf1f8853529c2fb0a3e5abda55.webp) **Less Than** | - Number variables - List variables | Match if the information in the variable is less than a specific value. | | ![Is True icon](/_fern-img/fcf3fe21099df957ee22609d5a5c211601d3e402fcc8402c12115f4680a692b0.webp) **Is True** | - Yes/No variables | Match if the information in a variable is Yes (or True). | | ![Is False icon](/_fern-img/2b5c661e7e4445f1ea8f7736ee5b58b14f72283faf2dbd4f01220a26d621b238.webp) **Is False** | - Yes/No variables | Match if the information in a variable is No (or False). | | ![Does Not Contain icon](/_fern-img/2a459cf7a992abeb5cbdf8438f9f1be356bb5fcf915f55f7f1c2cdc3173b101d.webp) **Does Not Contain** | - List variables | Match if none of the selected items contains this value. | | ![Is Equal To icon](/_fern-img/7266dedcf2da1af5c496469379bd4fb68d5e65492c190e9567c75edbbbf7e260.webp) **Is Equal To** | - List variables | Match if the end user selected a particular number of options in a List Option block. | | ![Is Greater Than icon](/_fern-img/45636711dfe933087353da3923c6865b6816ea671ad6e9db4739aeea4c80a697.webp) **Is Greater Than** | - List variables | Match if the end user selected more than a particular number of options in a List Option block. | | ![Is Less Than icon](/_fern-img/f2448b33a8931270e63ea8daab74e67ade1fdfdf1f8853529c2fb0a3e5abda55.webp) **Is Less Than** | - List variables | Match if the end user selected fewer than a particular number of options in a List Option block. | 6. In the **Value** field, enter or select a value for the variable that you want to use to target end users. 7. If required, add additional conditions. * To add a new **top-level** condition, click **Add** ![](/_fern-img/b0aa6bd9ade574c33763556b72bedb3fb7ba2384bf0c25ef6cc5401eab220757.webp). If you're adding your first additional top-level condition, in the dropdown that appears, choose **And** or **Or** as the operator for all of your top-level conditions. * To create or add to a **group** of conditions, click the **Add to group** icon ![](/_fern-img/881a5902ee010bd99b16914b2ac663810ad93cade88c2fddc273b4c3bc508b28.webp) beside a condition you want to include in the group. If you're creating a group, in the dropdown that appears, choose **And** or **Or** as the operator for all of the conditions in that group. 4. Click **Save**. Your AI Agent updates the availability for the selected articles, and lists the rules you set in the Availability column. ### Filter articles Filter Knowledge articles by shared attributes such as language, activation state, source, or availability. **To filter articles:** 1. On the Ada dashboard, go to **Config > AI AGENT > Knowledge**. 2. Under **Articles**, open the **Filter** drop-down. Select a [filter type](#filter-types): **Language**, **State**, **Source**, or **Availability**. 3. Choose an **Operator** (e.g., **Is**, **Is Not**). 4. Select a **Value** (e.g., "en" for Language, "Active" for State, a specific source, or an availability rule). 5. Click **Apply** to update the article list. #### Filter types Several filter types are available, each serving a specific use case: * **State (Active/Inactive):** Filter to show only articles that are currently active or inactive. Useful for bulk activation/deactivation and auditing live content. * **Source:** Filter articles by their source (e.g., Zendesk, Created in Ada, Imported Website) to manage or review content from specific integrations. This is helpful when multiple knowledge sources are connected and you want to isolate or troubleshoot content from a particular system. Articles written in Ada default to **Created in Ada**, but articles written through the [MCP server](/mcp/tools/edit-agent-behavior) can be filed under another source, so the source filter shows where an article is grouped, not whether it can be edited in Ada. * **Language:** Filter articles based on the language code. Useful for multilingual AI Agents to manage or review content in a specific language, or to ensure coverage across supported languages. * **Availability:** Filter by custom rules (e.g., region, end user segment) defined in the article's rules field. This is useful when you need to quickly verify or edit articles that are available only for specific use cases. These filters can be combined for granular control and bulk operations in the Ada dashboard. ## Related features Explore related Knowledge capabilities: * **[Article creation](/docs/knowledge/content-ingestion/article-creation)**: Create Knowledge articles directly in Ada. * **[Knowledge integrations](/docs/knowledge/content-ingestion/knowledge-integration)**: Connect external knowledge bases like Zendesk, Salesforce, or Contentful. * **[Web import](/docs/knowledge/content-ingestion/web-import)**: Import content from public-facing websites. --- Have any questions? Contact your Ada team, or email us at [](mailto:help@ada.cx?subject=Help%20Docs%20inquiry).