# Articles & Collections

## Articles

Articles each have their own URL with a customizable slug. For more information on writing articles, see the [editor](https://docs.usepylon.com/pylon-docs/knowledge-base/articles-and-collections/editor "mention") section.

### Visibility

You have fine-grained control of the visibility of articles. Articles can be:

**Public**: Visible to everyone

**Customer**: Available to logged-in customers. You can optionally specify properties that viewers must meet to view the article. For example, specifying they must be on the Enterprise tier or part of a certain account can help you create articles tailored to only relevant segments of your customer base.

**Internal**: Only visible to users on your team (but not to AI Agents)

**AI Agent Only:** Visible to your team + AI Agents, but not visible to customers

<div data-full-width="false"><figure><img src="https://982123570-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9hXBoCTTNw5flARlUVJf%2Fuploads%2F21INs1P7eGkDSkmrsZsb%2FScreenshot%202025-06-03%20at%206.26.22%E2%80%AFPM.png?alt=media&#x26;token=8441608c-5e9d-4982-b606-683f45b156b7" alt=""><figcaption></figcaption></figure></div>

Articles can also be set to be hidden -- this hides public/customer articles in the search for everyone but your team, but makes them accessible via a direct link. This is particularly useful for upcoming features that aren't released yet, or workarounds/setup that you don't want to draw too much attention to.

<figure><img src="https://982123570-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9hXBoCTTNw5flARlUVJf%2Fuploads%2Fg3aTEAyOwvMMRlvAqXXh%2FScreenshot%202025-06-03%20at%206.28.35%E2%80%AFPM.png?alt=media&#x26;token=eff51505-ca01-4ae8-b2c8-d72f8e4d70e8" alt=""><figcaption></figcaption></figure>

### Version History

Every time an article is published, it creates a new version. This allows you to review any changes made, or to revert to a historical version of the article at any time.

### Feedback

Articles by default come with embedded feedback collection. On the bottom of each article is a place for viewers to leave a 1-5 rating and free form feedback about the article.&#x20;

You can view the submitted feedback in the "Performance" tab of the Knowledge Base configuration or set up Slack notifications for new feedback submissions in the Notifications tab.

## Collections

Collections are folders that contain articles or other collections. Each has their own URL, with options to customize the URL slug and icon for a collection on its settings page. You can also set visibility rules that will apply to all articles within that collection.

<figure><img src="https://982123570-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9hXBoCTTNw5flARlUVJf%2Fuploads%2F4iHlsCOBjeLobLUzJb5o%2FCleanShot%202024-12-07%20at%2021.01.20.png?alt=media&#x26;token=322b8a1b-e284-41a8-ab77-e34ec31bbd5b" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
You can create multiple separate knowledge bases by using articles and collections. This can be especially useful if you have different tiers of your product or well-defined sets of users with different product needs
{% endhint %}


---

# Agent Instructions: 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:

```
GET https://docs.usepylon.com/pylon-docs/knowledge-base/articles-and-collections.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.