> ## Documentation Index
> Fetch the complete documentation index at: https://mainwp-docs-openapi-6-1-5-fixes.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Atarim

> The Atarim Extension for MainWP expands your ability to collaborate with your clients through your MainWP Dashboard. Get a complete overview of tasks that have been created inside your websites using Atarim to keep track of all your client requests!

## What You'll Learn

* Connecting Atarim to your MainWP Dashboard
* Connecting MainWP to your Atarim Dashboard
* Viewing Atarim tasks in the Manage Sites and Monitoring tables
* Including Atarim data in Pro Reports

***

<div id="addon-data" style={{display: 'none'}} data-title="Atarim" data-purchase-url="https://mainwp.com/extension/atarim/" data-pricing-tier="pro" data-bundle="MainWP Pro" data-addon-type="integration" data-version="5.0.1" data-developer="MainWP" data-changelog-url="https://mainwp.com/changelog/mainwp-atarim-extension/" data-integrates-with="Atarim" data-owned-by="WP FeedBack LTD" data-privacy-url="https://atarim.io/privacy-policy/" />

<Info>
  **Integration Add-on** - This add-on extends MainWP to work with Atarim. Requires Atarim to be installed on your child sites.
</Info>

Atarim is a service for collaborating with your clients. Two-way integration offers an insight into website status on Atarim Dashboard and an insight into Atarim tasks on the MainWP Dashboard. Please note that this integration requires a [paid Atarim plan](https://atarim.io/pricing/) (Starter, Expert, or Agency).

## Connect Atarim to MainWP Dashboard

<Steps>
  <Step title="Install Atarim Extension">
    [Install](/dashboard/overview/manage-extensions#install-extensions) Atarim [Extension](https://mainwp.com/extension/atarim/)
  </Step>

  <Step title="Go to Atarim Dashboard > Settings > Integrations Settings page" />

  <Step title="Enable MainWP Integration and copy the API Key">
    Enable MainWP Integration and copy the API Key <img src="https://mintcdn.com/mainwp-docs-openapi-6-1-5-fixes/d4G0QMpnE6JE0wOT/images/add-ons/67bcddbb05b0.png?fit=max&auto=format&n=d4G0QMpnE6JE0wOT&q=85&s=21700e82d07d6abd000a26eebfb5845f" alt="Atarim & MainWP integration API Key" width="1222" height="902" data-path="images/add-ons/67bcddbb05b0.png" />
  </Step>

  <Step title="Go to MainWP Dashboard > Add-ons > Administrative > Atarim > Settings page" />

  <Step title="Paste the API Key" />

  <Step title="Click the Save Settings button">
    Click the Save Settings button <img src="https://mintcdn.com/mainwp-docs-openapi-6-1-5-fixes/G5x3KdeCLBBQwkzj/images/add-ons/42178f40ecfd.png?fit=max&auto=format&n=G5x3KdeCLBBQwkzj&q=85&s=e7d89ad7469626bcbb976bc3639264d3" alt="Connect MainWP to Atarim settings" width="1315" height="661" data-path="images/add-ons/42178f40ecfd.png" />
  </Step>
</Steps>

After connecting with Atarim, MainWP will gain the following features:

* **Manage Sites and Monitoring tables**
  * A new column will be visible showing the number of Atarim tasks for child sites. Clicking the icon will reveal additional information about those tasks. <img src="https://mintcdn.com/mainwp-docs-openapi-6-1-5-fixes/d4G0QMpnE6JE0wOT/images/add-ons/782c77e43684.gif?s=4ffbebe13c2a012ccdb21a34359d3a9e" alt="Atarim Tasks modal element" width="1920" height="1080" data-path="images/add-ons/782c77e43684.gif" />
* **Overview widgets**
  * On the Overview and Individual Child site overview, a new widget will display information about Atarim tasks <img src="https://mintcdn.com/mainwp-docs-openapi-6-1-5-fixes/37VvENynzgqK-MB-/images/add-ons/atarim-tasks-widget.png?fit=max&auto=format&n=37VvENynzgqK-MB-&q=85&s=09892e47087e53ee2bf4407318c53368" alt="Atarim tasks widget" width="1920" height="1080" data-path="images/add-ons/atarim-tasks-widget.png" />
* **Pro Reports data note**: Pro Reports Extension version 4.0.11 or newer is required for Atarim data.
  * Atarim Data can be included in the Report from the **Report Data** section <img src="https://mintcdn.com/mainwp-docs-openapi-6-1-5-fixes/G5x3KdeCLBBQwkzj/images/add-ons/3e3c796fdd7f.png?fit=max&auto=format&n=G5x3KdeCLBBQwkzj&q=85&s=f6e5a8794cf5c406f7db178de092b0f2" alt="Atarim pro reports settings" width="944" height="452" data-path="images/add-ons/3e3c796fdd7f.png" />
  * Atarim data can also be included by using two tokens: `[atarim.all.tasks]` displays all tasks for a site within the selected date range, and `[atarim.billable.tasks]` displays all billable tasks for a site within the selected date range.

## Connect MainWP to Atarim Dashboard

<Steps>
  <Step title="Go to WP Admin > Settings > Permalinks page" />

  <Step title="Choose any settings except for Plain (this is a WordPress REST API limitation)">
    Choose any settings except for **Plain** (this is a WordPress REST API limitation) <img src="https://mintcdn.com/mainwp-docs-openapi-6-1-5-fixes/37VvENynzgqK-MB-/images/add-ons/atarim-permalink-settings.jpg?fit=max&auto=format&n=37VvENynzgqK-MB-&q=85&s=ded490580d1709b5633d1cad1628197c" alt="How Can I Enable MainWP REST API? 1" width="787" height="470" data-path="images/add-ons/atarim-permalink-settings.jpg" />
  </Step>

  <Step title="Go to MainWP Dashboard > API Access > API Keys > Add API Keys page" />

  <Step title="Create an API key and enable MainWP REST API v1 Compatibility" />

  <Step title="Copy Consumer Key and Consumer Secret">
    Click **Show Legacy API Credentials**, then copy Consumer Key and Consumer Secret. <img src="https://mintcdn.com/mainwp-docs-openapi-6-1-5-fixes/G5x3KdeCLBBQwkzj/images/add-ons/23ee66b7b918.png?fit=max&auto=format&n=G5x3KdeCLBBQwkzj&q=85&s=c4c24276d0419b3bef521558d161f398" alt="Enable REST API in MainWP" width="1821" height="533" data-path="images/add-ons/23ee66b7b918.png" />
  </Step>

  <Step title="Click Save Key" />

  <Step title="Go to Atarim Dashboard > Settings > Integrations Settings page" />

  <Step title="Find the MainWP Integration section" />

  <Step title="Paste the Consumer Key and Consumer Secret, and the URL of your MainWP Dashboard">
    Paste the Consumer Key and Consumer Secret, and the URL of your MainWP Dashboard <img src="https://mintcdn.com/mainwp-docs-openapi-6-1-5-fixes/37VvENynzgqK-MB-/images/add-ons/atarim-mainwp-integration.png?fit=max&auto=format&n=37VvENynzgqK-MB-&q=85&s=42c2feb510cb7933775a19e1a11d2345" alt="Enable MainWP & Atarim integration in your Atarim account" width="1180" height="886" data-path="images/add-ons/atarim-mainwp-integration.png" />
  </Step>
</Steps>

After connecting with MainWP, Atarim will display the **number of available updates, a number of security issues,** and the **uptime status** of the sites. <img src="https://mintcdn.com/mainwp-docs-openapi-6-1-5-fixes/37VvENynzgqK-MB-/images/add-ons/atarim-site-status.png?fit=max&auto=format&n=37VvENynzgqK-MB-&q=85&s=6eeac7ed7260bdf589b97d283eab0e0e" alt="Site info" width="608" height="281" data-path="images/add-ons/atarim-site-status.png" /> ***Learn more about the [Atarim extension](https://mainwp.com/extension/atarim/)!***

## How to disable Atarim on the Manage Sites table

### How to hide the Atarim column

<Steps>
  <Step title="Go to MainWP Dashboard > Sites > Manage Sites page" />

  <Step title="Click the Cog icon (Page Settings) in the top right" />

  <Step title="De-select Atarim in the Show Columns section">
    De-select Atarim in the **Show Columns** section <img src="https://mintcdn.com/mainwp-docs-openapi-6-1-5-fixes/37VvENynzgqK-MB-/images/add-ons/atarim-hide-column.gif?s=f4a25247ecf7fcffe2810285b1242653" alt="Remove Atarim column from the Manage Sites table." width="1920" height="1080" data-path="images/add-ons/atarim-hide-column.gif" />
  </Step>

  <Step title="Click the Save Settings button" />
</Steps>

### How to unset the Atarim column

Insert the following snippet using our [Custom Dashboard](https://mainwp.com/extension/mainwp-custom-dashboard-extension/) extension, or by inserting it in the `functions.php` file of the active theme of your MainWP Dashboard:

```php theme={null}
add_filter( 'mainwp_sitestable_getcolumns', 'myhook2_mainwp_sitestable_getcolumns', 20, 2 );
function myhook2_mainwp_sitestable_getcolumns( $columns ) {
	if ( is_array( $columns ) && isset( $columns['atarim_tasks'] ) ) {
		unset( $columns['atarim_tasks'] );
	}
	return $columns;
}

```

<img src="https://mintcdn.com/mainwp-docs-openapi-6-1-5-fixes/37VvENynzgqK-MB-/images/add-ons/atarim-custom-dashboard-snippet.png?fit=max&auto=format&n=37VvENynzgqK-MB-&q=85&s=da9b81ba5d981e115f10745f47e6ac48" alt="Custom Dashboard, PHP code snippet" width="954" height="512" data-path="images/add-ons/atarim-custom-dashboard-snippet.png" />

***

## Related Resources

* [Administrative Add-ons](/add-ons/administrative) - Browse all administrative tools
* [Pro Reports Extension](/add-ons/agency/pro-reports-extension-overview) - Include Atarim data in reports
* [Custom Dashboard Extension](/add-ons/development/mainwp-custom-dashboard-extension) - Add custom code snippets
