> ## 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.

# Tracking WordPress: access and activity logs

> Monitor and troubleshoot WordPress integration activity using access logs and activity tracking in the HoopAI platform.

When you connect WordPress to the HoopAI platform, tracking access and activity logs helps you monitor how the integration is performing, diagnose issues, and ensure data flows correctly between your WordPress site and Hoop.

***

## Understanding WordPress activity logs

Activity logs record every interaction between your WordPress site and the HoopAI platform. These logs capture:

* **Form submissions** synced from WordPress to Hoop
* **Contact creation and updates** triggered by WordPress events
* **Plugin connection status** changes
* **Error events** when data fails to sync

<Info>
  Activity logs are retained for 30 days. If you need to investigate an issue older than 30 days, you may need to check your WordPress server logs directly.
</Info>

***

## Viewing access logs

### In the HoopAI platform

<Steps>
  <Step title="Navigate to settings">
    Go to **Settings > Integrations** and locate your WordPress integration.
  </Step>

  <Step title="Open the integration details">
    Click on the WordPress integration card to view connection details and recent activity.
  </Step>

  <Step title="Review the activity log">
    Check the activity log for recent sync events, errors, and connection status updates.
  </Step>
</Steps>

### In WordPress

You can also monitor the integration from the WordPress side:

<Steps>
  <Step title="Access the plugin settings">
    In your WordPress admin dashboard, navigate to the Hoop plugin settings page.
  </Step>

  <Step title="Check the connection status">
    Verify that the plugin shows a connected status with a green indicator. A red or orange indicator means the connection needs attention.
  </Step>

  <Step title="Review sync history">
    Look at the sync history section to see recent data transfers, including timestamps and statuses.
  </Step>
</Steps>

***

## Common issues and solutions

### Plugin shows disconnected

If the WordPress plugin shows a disconnected status:

* **Re-authenticate** — Go to the plugin settings and click the reconnect or re-authenticate button. You may need to log in to your Hoop account again.
* **Check API keys** — Verify that the API key in the plugin settings matches the one in your Hoop account under **Settings > Integrations**.
* **Verify server requirements** — Ensure your WordPress hosting meets the minimum PHP version and has outbound HTTPS connections enabled.

<Warning>
  If you recently changed your Hoop account password or API keys, you must update them in the WordPress plugin settings as well. Old credentials will cause the connection to fail.
</Warning>

### Form submissions not syncing

If WordPress form submissions are not appearing in Hoop:

<Steps>
  <Step title="Verify form mapping">
    In the plugin settings, confirm that each WordPress form is mapped to the correct Hoop form or contact fields.
  </Step>

  <Step title="Check for JavaScript conflicts">
    Other WordPress plugins (especially caching or minification plugins) can interfere with form tracking scripts. Temporarily disable other plugins to test.
  </Step>

  <Step title="Review error logs">
    Check the activity log for failed sync attempts. Common errors include timeout errors (your server took too long to respond) and authentication errors.
  </Step>

  <Step title="Test with a fresh submission">
    Submit a test form entry and check whether it appears in Hoop within a few minutes.
  </Step>
</Steps>

### Duplicate contacts being created

Duplicates can occur when:

* The same form is submitted multiple times by a user
* The WordPress plugin and another integration (such as Zapier) are both sending the same data to Hoop
* Contact matching rules are not configured to deduplicate by email address

<Tip>
  Enable **email-based deduplication** in your Hoop contact settings to prevent the same email address from creating multiple contact records.
</Tip>

### Slow sync or delayed data

If data takes longer than expected to sync:

* **Check your WordPress hosting performance** — Shared hosting plans with limited resources can delay outbound API calls
* **Review cron job configuration** — Some WordPress hosts disable or limit WP-Cron, which can delay scheduled syncs. Ask your host to enable system cron jobs as an alternative.
* **Check Hoop system status** — Occasionally, platform-wide delays may affect sync times

***

## Monitoring best practices

| Practice                  | Frequency                  | Why                                      |
| ------------------------- | -------------------------- | ---------------------------------------- |
| Review activity logs      | Weekly                     | Catch sync errors early                  |
| Test form submissions     | After any plugin update    | Confirm integration still works          |
| Check connection status   | Weekly                     | Ensure the plugin stays connected        |
| Update the plugin         | When updates are available | Bug fixes and compatibility improvements |
| Review duplicate contacts | Monthly                    | Prevent list quality issues              |

***

## FAQs

<AccordionGroup>
  <Accordion title="How far back do activity logs go?">
    Activity logs in the HoopAI platform are retained for 30 days. WordPress server logs may retain data longer depending on your hosting configuration.
  </Accordion>

  <Accordion title="Can I export the activity logs?">
    Currently, activity logs cannot be exported directly from the platform. You can take screenshots or copy the relevant entries for your records.
  </Accordion>

  <Accordion title="Does the WordPress plugin work with custom post types?">
    The plugin primarily tracks form submissions and standard WordPress events. Custom post type tracking depends on the specific plugin version and configuration. Check the plugin documentation for supported post types.
  </Accordion>

  <Accordion title="What happens to my data if the plugin disconnects?">
    Data generated while the plugin is disconnected will not sync automatically. Once reconnected, only new events will be captured. You may need to manually import any data that was created during the disconnection period.
  </Accordion>
</AccordionGroup>