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

# Listings

> Sync and manage your business information across online directories, track analytics, handle duplicates, and optimize your online presence from the HoopAI Platform.

The Listings feature helps you maintain accurate and consistent business information across major online directories. Keeping your listings up to date improves local SEO and ensures customers can always find you.

Navigate to **Reputation > Listings** to access these tools.

## Listings overview

The Listings Overview evaluates how your business performs across major platforms and provides a centralized snapshot of your online visibility.

<Frame caption="Listings Overview dashboard">
  <img src="https://mintlify.s3.us-west-1.amazonaws.com/hoopai-84ec0cdc/images/reputation-listings-overview.png" alt="Listings Overview" />
</Frame>

Click **Create Entity** in the upper-right to manage listings across multiple business locations. After adding entities, the dashboard displays:

* Total number of entities and their assigned categories
* Associated publishers
* Number of social media platforms where your listings have been identified

### Online presence widget

Spotlights social media platforms that have not been fully configured for your entities, making it easy to identify gaps and link those platforms directly.

<Frame caption="Online Presence widget highlighting unconfigured platforms">
  <img src="https://mintlify.s3.us-west-1.amazonaws.com/hoopai-84ec0cdc/images/reputation-listings-presence.png" alt="Online Presence" />
</Frame>

### Incomplete business data widget

Shows how many entities are missing essential social media information. Completing these details ensures potential customers can easily discover and connect with your business.

### Suggestions widget

Review and apply recommended changes to enhance your business listings. These suggestions are based on updates submitted by publishers to keep your information accurate and up to date.

<Frame caption="Suggestions widget with publisher-recommended updates">
  <img src="https://mintlify.s3.us-west-1.amazonaws.com/hoopai-84ec0cdc/images/reputation-listings-suggestions.png" alt="Suggestions" />
</Frame>

### To-do list

Provides a concise summary of key actionable insights with brief explanations of their importance, helping you prioritize tasks that enhance your online presence.

<Frame caption="To-Do List for listing improvements">
  <img src="https://mintlify.s3.us-west-1.amazonaws.com/hoopai-84ec0cdc/images/reputation-listings-todo.png" alt="To-Do List" />
</Frame>

***

## Managing business information

### Upload logo and gallery media

Business logos and photos can be uploaded, managed, and edited directly within the platform.

<Steps>
  <Step title="Navigate to your entity">
    Go to **Reputation > Listings** and select the correct business entity.
  </Step>

  <Step title="Access Edit Listing Information">
    Navigate to the **Edit Listing Information** section.

    <Frame caption="Edit Listing Information screen">
      <img src="https://mintlify.s3.us-west-1.amazonaws.com/hoopai-84ec0cdc/images/reputation-listings-edit-info.png" alt="Listing Info Edit" />
    </Frame>
  </Step>

  <Step title="Select Media">
    Click **Media** to upload new images or edit existing ones. Supported formats: PNG, JPEG, WEBP, and static GIFs (max 5MB).

    <Frame caption="Media upload section">
      <img src="https://mintlify.s3.us-west-1.amazonaws.com/hoopai-84ec0cdc/images/reputation-listings-media-upload.png" alt="Media Upload" />
    </Frame>
  </Step>

  <Step title="Edit images">
    Use the built-in tools for cropping, mirroring, rotating, and adjusting aspect ratios.

    <Frame caption="Image editing tools">
      <img src="https://mintlify.s3.us-west-1.amazonaws.com/hoopai-84ec0cdc/images/reputation-listings-image-edit.png" alt="Image Editor" />
    </Frame>
  </Step>

  <Step title="Save changes">
    Click **Save** to apply your changes.
  </Step>
</Steps>

<Note>
  Business logos must maintain a consistent 1:1 aspect ratio to ensure uniformity across the platform.
</Note>

### Add service areas and hide address

<Steps>
  <Step title="Open Edit Listing Information">
    Navigate to the entity's profile and click **Edit Listing Information**.
  </Step>

  <Step title="Hide your address (optional)">
    Enable the **Hide Business Address** checkbox to keep your address private on online listings.
  </Step>

  <Step title="Add service areas">
    Enable **"We provide service at customer locations"** to open the Service Areas menu. Select the preferred area type: **City**, **Zip Code**, or **Sub-locality**.

    <Frame caption="Service area configuration">
      <img src="https://mintlify.s3.us-west-1.amazonaws.com/hoopai-84ec0cdc/images/reputation-listings-service-areas.png" alt="Service Areas" />
    </Frame>
  </Step>

  <Step title="Enter location details">
    Type a location — the system generates suggestions. Select the most appropriate from the list.
  </Step>

  <Step title="Add multiple areas">
    Click **+ Add Service Area** and repeat to add additional locations.
  </Step>

  <Step title="Save">
    Verify all details and click **Save**.
  </Step>
</Steps>

***

## Listings analytics

The Listings Analytics Dashboard provides insights into your listings' performance with real-time data.

<Frame caption="Listings Analytics Dashboard">
  <img src="https://mintlify.s3.us-west-1.amazonaws.com/hoopai-84ec0cdc/images/reputation-listings-analytics.png" alt="Analytics Dashboard" />
</Frame>

Navigate to **Reputation > Listings > Analytics** to access the dashboard.

| Metric                         | Description                                                       |
| ------------------------------ | ----------------------------------------------------------------- |
| **Total listings impressions** | How often your listings appear in search results                  |
| **Total listings actions**     | User interactions including clicks, calls, and direction requests |
| **Device usage over time**     | How users access listings across mobile, desktop, and tablet      |
| **Profile views**              | How many users are viewing your business listings                 |
| **Platform insights**          | Breakdown of profile views by platform                            |

Use the **date filter** to view specific data for a selected timeframe.

***

## Request force sync

If listing updates are delayed, use Force Sync to manually request priority processing.

<Note>
  Force Sync helps prioritize updates, but final publishing times still depend on each publisher.
</Note>

**When to use Force Sync:**

* Listing updates have been pending longer than expected
* Changes are time-sensitive and need priority attention
* You want to take a proactive approach to managing listing accuracy

<Steps>
  <Step title="Open your listing">
    Navigate to the Listings section and select the entity you want to update.
  </Step>

  <Step title="Choose sync scope">
    Force Sync can be applied at the **entity level** (all connected publishers) or **publisher level** (a specific publisher only).

    <Frame caption="Force Sync options">
      <img src="https://mintlify.s3.us-west-1.amazonaws.com/hoopai-84ec0cdc/images/reputation-listings-force-sync.png" alt="Force Sync" />
    </Frame>
  </Step>

  <Step title="Request Force Sync">
    Click **Request Force Sync** for the selected scope, then confirm your request.
  </Step>
</Steps>

***

## Duplicate suppression

Duplicate listings — extra profiles that represent the same business — can split ranking power, confuse customers, and display outdated information. Duplicate Suppression helps you detect and remove these extra listings.

<Frame caption="Duplicate Suppression tab in Listings">
  <img src="https://mintlify.s3.us-west-1.amazonaws.com/hoopai-84ec0cdc/images/reputation-listings-duplicates.png" alt="Duplicate Suppression" />
</Frame>

<Note>
  The Duplicate Suppression tab is only visible if the account has an active Yext entity.
</Note>

### How duplicate detection works

* **Monthly automated scans** run across major directories to identify potential duplicate listings
* Listings are flagged based on matching signals: business name, address, phone number (NAP), and other identifying details
* For multi-location brands, confirm the flagged listing is not a separate franchise, nearby branch, or previous address

### Duplicate statuses

| Status                     | Meaning                                                                  |
| -------------------------- | ------------------------------------------------------------------------ |
| **Possible duplicate**     | Flagged and awaiting your review                                         |
| **Processing suppression** | Suppression requested; publisher is reviewing (\~24 hours, up to a week) |
| **Suppressed**             | Duplicate removed from search results                                    |
| **Unable to suppress**     | Publisher declined; may need additional documentation                    |

### Managing duplicates

<Steps>
  <Step title="Review the listings grid">
    Compare business name, address, phone number, and details to confirm it is truly the same business.

    <Frame caption="Duplicates grid with columns for Site, Your Listing, Duplicate Listing, Status, and Actions">
      <img src="https://mintlify.s3.us-west-1.amazonaws.com/hoopai-84ec0cdc/images/reputation-listings-duplicate-grid.png" alt="Duplicates Grid" />
    </Frame>
  </Step>

  <Step title="Suppress a confirmed duplicate">
    Click **Suppress**, then **Confirm**. The status changes to "Processing Suppression."

    <Frame caption="Suppress duplicate confirmation">
      <img src="https://mintlify.s3.us-west-1.amazonaws.com/hoopai-84ec0cdc/images/reputation-listings-suppress.png" alt="Suppress Duplicate" />
    </Frame>
  </Step>

  <Step title="Dismiss a false positive">
    If the listing is NOT a duplicate, click **Not a Duplicate**, then **Confirm**. The listing is removed from the suppression queue.

    <Frame caption="Not a duplicate action">
      <img src="https://mintlify.s3.us-west-1.amazonaws.com/hoopai-84ec0cdc/images/reputation-listings-not-duplicate.png" alt="Not a Duplicate" />
    </Frame>
  </Step>
</Steps>

<Tip>
  Revisit the Duplicate Suppression tab monthly since automated scans refresh regularly. Consistent review keeps your online presence clean and optimized.
</Tip>

***

## Cancelling Yext listings

<Steps>
  <Step title="Open Business Entities">
    Go to **Reputation > Listings > Business Entities**.
  </Step>

  <Step title="Initiate unsubscribe">
    Click the three-dot icon next to the business and select **Unsubscribe**.

    <Frame caption="Unsubscribe from Yext Listings">
      <img src="https://mintlify.s3.us-west-1.amazonaws.com/hoopai-84ec0cdc/images/reputation-listings-unsubscribe.png" alt="Unsubscribe" />
    </Frame>
  </Step>

  <Step title="Confirm and provide reason">
    Click **Next**, confirm your decision, and provide a reason for the cancellation.
  </Step>
</Steps>

<AccordionGroup>
  <Accordion title="What if cancellation fails?">
    An error message will display. Submit a cancellation request to our support team for assistance.
  </Accordion>

  <Accordion title="Can I reactivate after cancellation?">
    Yes. You can reactivate Listings at any time by following the setup process within your account.
  </Accordion>

  <Accordion title="Will business info be removed after cancellation?">
    No. The information will remain in directories but will no longer be actively managed or updated through your account.
  </Accordion>

  <Accordion title="Is there a cancellation fee?">
    No. You can cancel at any time with no additional fees. Billing stops immediately upon cancellation.
  </Accordion>
</AccordionGroup>

<Note>
  Listing Add-on Cancellation is only applicable for those who submitted the form 30 days before initiating the cancellation request.
</Note>

***

## Listings sync status and error handling

Understanding sync status helps you identify when listing data is not propagating correctly across directories.

### Sync status indicators

| Status         | Meaning                                                              |
| -------------- | -------------------------------------------------------------------- |
| **Synced**     | Business data matches what is published on the directory             |
| **Syncing**    | An update has been submitted and is being processed by the publisher |
| **Error**      | The publisher rejected or could not apply the update                 |
| **Not synced** | No listing exists on that publisher for this entity                  |

### Common sync errors and fixes

<AccordionGroup>
  <Accordion title="Publisher rejected the update">
    Some publishers have strict data validation requirements — for example, character limits on business names, required phone number formats, or mandatory website fields. Review the error details shown next to the publisher and update your listing information to match the publisher's requirements.
  </Accordion>

  <Accordion title="Update has been syncing for more than 48 hours">
    Use **Request Force Sync** at either the entity or publisher level to re-submit the update with priority status. If the issue persists after 48 additional hours, contact HoopAI support.
  </Accordion>

  <Accordion title="Address validation failed">
    Ensure your business address is formatted to match official postal standards. Use the full street address including suite or unit numbers. Service-area businesses without a public address can enable **Hide Business Address** and define service areas instead.
  </Accordion>

  <Accordion title="Phone number format rejected">
    Format your phone number with the country code prefix (e.g., +1 for US numbers). Remove any extensions from the primary phone number field.
  </Accordion>
</AccordionGroup>

***

## FAQs

<AccordionGroup>
  <Accordion title="Does HoopAI use Yext for listings management?">
    Yes. The Listings feature is powered by Yext, which syncs your business information to major directories and review sites. An active Yext entity is required for the Listings section to function. Contact your platform administrator to enable it.
  </Accordion>

  <Accordion title="How long does it take for listing updates to appear on directories?">
    Most updates appear within 24–72 hours, though some publishers take longer. Use **Request Force Sync** to prioritize a pending update. Final publishing time ultimately depends on each individual publisher's processing schedule.
  </Accordion>

  <Accordion title="Will cancelling Yext remove my business info from directories?">
    No. Cancelling your Yext subscription stops active management and updates, but existing listing information already published on directories remains. Publishers do not automatically remove listings when you unsubscribe.
  </Accordion>

  <Accordion title="How does duplicate suppression work?">
    HoopAI runs automated monthly scans across major directories to identify listings that share the same business name, address, and phone number (NAP) as your active listing. Flagged duplicates are presented for your review — you can suppress confirmed duplicates or dismiss false positives. Suppression requests are sent to the publisher and typically resolve within 24 hours to one week.
  </Accordion>

  <Accordion title="Can I manage listings for multiple business locations?">
    Yes. Click **Create Entity** for each business location. Each entity has its own profile, sync status, analytics, and duplicate suppression queue. Switch between entities from the main Listings dashboard.
  </Accordion>

  <Accordion title="What image formats are supported for listings media?">
    Supported formats are PNG, JPEG, WEBP, and static GIFs (no animated GIFs). Maximum file size is 5MB. Business logos must maintain a 1:1 aspect ratio. Use the built-in editor for cropping, mirroring, and rotating after upload.
  </Accordion>

  <Accordion title="What is the Incomplete Business Data widget?">
    This widget highlights entities that are missing key fields such as phone number, website, description, or hours. Completing these fields improves your visibility in local search results and ensures customers have accurate contact information.
  </Accordion>
</AccordionGroup>