> For the complete documentation index, see [llms.txt](https://docs.linuxfoundation.org/lfx/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.linuxfoundation.org/lfx/project-control-center/v2-latest-version/reports/social-listening.md). # Social Listening Social Listening is a feed of mentions of your project across public social and community platforms, letting you track what people are saying about it in one place. This page applies to users who have "View All" access to project goals for the project (the same permission that controls access to Health Metrics), on a project that is Active and at the foundation level. If you don't see the Social Listening report under the Reports tab, contact support to check your project's access. The mentions shown come from Octolens and include only publicly available content collected from third-party platforms across the web (for example X/Twitter, Bluesky, Reddit, YouTube, Facebook, Hacker News, DEV, podcasts, GitHub, and LinkedIn). The Linux Foundation does not independently collect, enrich, or modify this data. ### Accessing Social Listening 1. Log in to your PCC account. 2. Search for the required project. 3. Click the **Reports** tab. 4. Select **Social Listening**. The page opens on the **Feed** tab, with a separate **Analytics** tab for aggregated charts (total mentions, sentiment breakdown, mentions over time, mentions by platform, mentions by tag, and top projects). ### The mentions feed The feed shows the most recent mentions of your project, with each mention displayed as a card. Each mention card shows: * The platform icon and name (for example Reddit, YouTube, LinkedIn). * The keyword the mention matched. * How long ago the mention was posted. * The author's name, linked to their profile when a profile link is available. * The mention's title (when the source content has one) and body content, with a "show more" / "show less" toggle for long text. * A short analysis summary. * A sentiment pill (Positive, Neutral, or Negative) and a relevance pill (High or Low relevance). * Any tags associated with the mention. * A thumbnail image, when the source content includes one. Mentions you haven't opened or marked yet are shown as unread; mentions you've opened or explicitly marked are shown as read. Above the feed, you can: * See how many mentions are currently loaded out of the total (for example "20 of 143"). * Click **Mark all as read** to mark every currently loaded mention as read. * Click **Mark all as unread** to mark every currently loaded mention as unread. * See when the data was last computed ("Data as of ..."). Use the paginator below the feed to move between pages of results. Above the feed, the feed header also lets you: * Switch between the **Feed** and **Analytics** tabs. * Choose a project (when your project has sub-projects) and a platform to scope the feed to. * Choose a date range (Last 7 Days, Last 30 Days, Last 90 Days, Last 12 Months, or Year to Date). * Search mentions using the search box. * Open the saved views list and the filters panel, described below. ### Filtering mentions The filters panel lets you narrow the feed down using the following filters: * **Sentiment** — All, Positive, Neutral, or Negative. * **Relevance** — All, High, or Low. * **Language** — All, or a specific language detected in your project's mentions. * **Has Title** — All, Yes, or No, based on whether the mention has a title. * **Bookmarked** — All mentions, or only mentions you've bookmarked. * **Read Status** — All mentions, or only unread mentions. * **Authors** — a searchable list of authors who have mentioned your project, each showing how many mentions they've made. * **Keywords** — a searchable list of the keywords your project is tracked by. * **Tags** — a searchable list of tags applied to mentions. To open the filters panel: 1. Click the filter icon (next to the saved views button) in the feed header. A badge on the icon shows how many filters are currently active. 2. Choose values for any of the filters above. 3. Click **Clear all** to reset every filter back to its default. ### Bookmarking a mention Bookmarking lets you flag a mention so you can find it again later using the **Bookmarked** filter. 1. On any mention card, find the bookmark icon among the action icons on the right side of the card. 2. Click it to bookmark the mention. Click it again to remove the bookmark. The icon fills in solid when the mention is bookmarked, and is outlined when it isn't. Each mention card also has a **Copy Link** action to copy the mention's link, and a **Forward** action that opens an email draft with the mention's details. Clicking anywhere else on the card opens the original post (or marks the mention as read, if it has no link) and marks it as read. ### Saved filter views A saved filter view lets you save your current filter and scope selections so you can switch back to them later without re-entering them. To save the filters and scope you currently have set: 1. Set the filters, project, platform, and date range you want to save. 2. Click **Save as View** in the filters panel (or **Save current view** in the saved views list). 3. In the **Save current view** dialog, enter a **View name** (up to 50 characters). 4. Click **Save**. If a view with that name already exists, you'll be asked to choose a different name. To switch views, open the saved views list from the feed header (it shows the current view's name, or "No Preset View" if none is applied) and select a view, or select **No Preset View** to return to the default, unfiltered feed. To delete a saved view, open the saved views list, click the trash icon next to the view, and confirm by clicking **Remove**. You can save up to 50 views per project. Once you reach that limit, you'll need to remove an existing view before you can save a new one. If you open a link someone else shared that points to a saved view you don't own, a banner lets you know these filters were saved by the person who shared the link, and gives you the option to save them as your own view. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## 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, and the optional `goal` query parameter: ``` GET https://docs.linuxfoundation.org/lfx/project-control-center/v2-latest-version/reports/social-listening.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. 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.