# Mentions Feed Overview

> Use the Mentions Feed to review collected social and web mentions in real time.

> Review, search, sort, tag, act on, and export individual mentions collected by Kommon Poll.

The Mentions Feed is where high-level analytics become real conversations. Use it to inspect the posts, comments, articles, reviews, and web mentions behind every chart or KPI.

---

## 1. Open The Mentions Feed

1. Open a search result or saved project.
2. Select the **Mentions** tab.
3. Confirm that the correct date range and filters are active.
4. Scan the first page of mention cards before drawing conclusions from charts.

The Mentions tab reflects the current search context. If you apply filters, sort options, or an internal search, the visible mention list changes.

---

## 2. What A Mention Card Shows

A mention card can include:

- Platform or source icon.
- Author, page, account, or publisher name.
- Published date and time.
- Title, caption, post text, article snippet, or highlighted text.
- Link to the original source when available.
- Media preview for images or videos.
- Sentiment label and score.
- Polarity and subjectivity where available.
- Engagement metrics such as likes, comments, shares, reactions, views, or interactions.
- Influence and reach metrics.
- Domain or source website.
- Mention type, such as post or comment.
- Tags already applied by you or your team.
- Priority badge where a mention is marked important.
- Scam or risk badge where a mention is classified as suspicious.

Not every platform exposes the same metadata. A missing field usually means the source did not provide it or it was not available for that mention.

---

## 3. Search Inside Current Mentions

The Mentions tab includes a search field for searching inside the currently loaded result context.

Use it to find:

- A specific keyword.
- A product name.
- A username or handle.
- A hashtag.
- A complaint phrase.
- A location, domain, or campaign term.

How to use it:

1. Open the Mentions tab.
2. Enter the word or phrase in the mention search field.
3. Run the internal search.
4. Review the returned mention cards.
5. Clear the internal search when you want to return to the full result set.

This is different from changing the main query. Internal mention search narrows the current result set; the main query controls what Kommon Poll searches for.

---

## 4. Sort Mentions

Sorting helps you decide what to review first.

Common sort modes include:

- Newest or oldest mentions.
- Highest influence.
- Highest engagement.
- Sentiment-oriented ordering where available.

How to use sorting:

1. Open the sort dropdown in the Mentions tab.
2. Choose the sort mode that matches your task.
3. Wait for the mention list to reload.
4. Review the first page again, because the order has changed.

Use newest-first for live monitoring, highest-influence for escalation, and engagement sorting for viral content review.

---

## 5. Control Mentions Per Page

The Mentions feed loads a fixed number of cards per page or request. In the current result flow, mention reloads commonly use 12 mentions at a time.

Use pagination or load controls to:

- Move through large result sets.
- Review the next batch of mentions.
- Keep the page responsive while inspecting heavy searches.

For broad searches, apply filters first. Reviewing a filtered list is faster and more accurate than scrolling through every mention.

---

## 6. Core Mention Actions

Mention cards expose actions based on the source and available permissions.

Common actions include:

- **Visit** - open the original post, article, or source page.
- **Add Tag** - label a mention for triage, reporting, or team workflows.
- **Add to Report** - save the mention as an example for a report export.
- **Reply** - open a reply workflow where supported.
- **Generate Response** - use AI to draft a reply for supported Facebook or Instagram replies.
- **Send** - send a prepared reply where the integration supports it.
- **Message** - open a conversation or message workflow where the connected source supports it.
- **Mark as complete** - mark a workflow item complete or reopen it where workflow status controls are available.
- **Delete** - remove or hide a mention from the working set where permitted.
- **Set sentiment** - manually correct or adjust sentiment.

Some actions only appear for supported platforms, connected accounts, or eligible mention types. For example, reply generation depends on the platform and whether the account connection can support that workflow.

---

## 7. Tag Mentions

Tags help teams classify mentions during review.

Use tags for:

- Complaints.
- Sales leads.
- PR risks.
- Campaign examples.
- Support follow-ups.
- Competitor mentions.
- Scam or impersonation examples.
- Report-ready posts.

How to tag a mention:

1. Click **Add Tag** on the mention card.
2. Enter or select the tag.
3. Save the tag.
4. Use Filters -> Tags later to find the tagged mentions.

Keep tag names short and consistent. For example, use `Complaint` everywhere instead of mixing `Complaint`, `Complaints`, and `Customer issue`.

---

## 8. Add Mentions To A Report

Use **Add to Report** when a mention is a useful example for a PDF, slide deck, or stakeholder summary.

Good report examples include:

- A high-reach positive post.
- A clear customer complaint.
- A representative negative comment.
- A media article that caused a spike.
- A competitor comparison post.
- A scam or impersonation example.

Before adding to a report:

1. Check that the mention is relevant to the report audience.
2. Confirm the sentiment and priority are accurate.
3. Avoid adding duplicate examples that say the same thing.
4. Tag the mention if it belongs to a recurring category.

---

## 9. Reply And Generate Responses

Reply controls are meant for engagement workflows, not just analysis.

When reply controls are available:

1. Open the mention card.
2. Click **Reply**.
3. Draft the response manually or click **Generate Response** where supported.
4. Review the generated text carefully.
5. Edit the response to match your brand voice and policy.
6. Click **Send** only when the response is ready.

Generated responses should always be reviewed by a person before sending, especially for complaints, legal issues, health topics, political content, crisis events, or sensitive customer cases.

---

## 10. Correct Sentiment

Sentiment can be adjusted from mention actions where the control is available.

Use manual sentiment correction when:

- Sarcasm was misclassified.
- A mixed post was scored too strongly.
- A short comment lacks enough context.
- Domain-specific language confused the model.
- A report depends on accurate examples.

Correcting sentiment improves the usefulness of filtered review and report examples, but it does not replace the need to read important mentions manually.

---

## 11. Message And Completion Workflows

Some mention workflows include **Message** and **Mark as complete** controls.

Use **Message** when:

- A mention needs a direct conversation.
- A platform or workflow supports opening a message thread.
- A teammate needs to continue the interaction in the connected channel.

Use **Mark as complete** when:

- The mention has been reviewed.
- The reply or escalation is done.
- The item no longer needs active attention.

If a completed item still needs later reporting, tag it before marking it complete so it remains easy to find.

---

## 12. Priority And Scam Badges

Priority and scam indicators help reviewers spot content that may need attention.

Use priority badges to find:

- High-risk complaints.
- Executive issues.
- Viral posts.
- Media-sensitive content.
- Time-sensitive customer cases.

Use scam or suspicious badges to review:

- Impersonation attempts.
- Fraud claims.
- Unsafe links.
- Fake pages or offers.
- Brand abuse.

If a badge appears on an important mention, open the original source and verify the context before escalating.

---

## 13. A Practical Review Workflow

For daily monitoring:

1. Open the saved project.
2. Set the date range to today or the current reporting window.
3. Filter by priority, negative sentiment, or high reach if needed.
4. Sort by newest for live review or influence for escalation.
5. Read the highest-risk mention cards.
6. Tag confirmed issues.
7. Reply or generate a response where appropriate.
8. Add the best examples to a report.
9. Ask Kommon Poll AI to summarize the filtered context.
10. Export or share only after reviewing the examples.

The Mentions Feed is the evidence layer for the dashboard. Use it to prove what the charts are saying.