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

# Atarim

> The Atarim Integration 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

***

> [!NOTE]
>
> **Integration Add-on** - This add-on extends MainWP to work with Atarim. Requires Atarim to be installed on your child sites.

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

**1. Install Atarim Integration**

[Install](https://docs.mainwp.com/dashboard/overview/manage-extensions.md#install-add-ons) the [Atarim Integration](https://mainwp.com/extension/atarim/)

**2. Go to Atarim Dashboard > Settings > Integrations Settings page**

**3. Enable MainWP Integration and copy the API Key**

Enable MainWP Integration and copy the API Key ![Atarim & MainWP integration API Key](https://mintcdn.com/mainwp/PMb515K3nlj7x2jI/images/add-ons/67bcddbb05b0.png?fit=max\&auto=format\&n=PMb515K3nlj7x2jI\&q=85\&s=67a9e15dcd7c7f5827cb1895632b8e23)

**4. Go to MainWP Dashboard > Add-ons > Administrative > Atarim > Settings page**

**5. Paste the API Key**

**6. Click the Save Settings button**

Click the Save Settings button ![Connect MainWP to Atarim settings](https://mintcdn.com/mainwp/2rlXQ4CNzTqDCqtT/images/add-ons/42178f40ecfd.png?fit=max\&auto=format\&n=2rlXQ4CNzTqDCqtT\&q=85\&s=244f985fff3c66c9f40fd02708471118)

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. ![Atarim Tasks modal element](https://mintcdn.com/mainwp/fYo8wl5GET5OrNvZ/images/add-ons/782c77e43684.gif?s=d1916597497aba849c654331b07019ad)
* **Overview widgets**
  * On the Overview and Individual Child site overview, a new widget will display information about Atarim tasks ![Atarim tasks widget](https://mintcdn.com/mainwp/j2Qcsx2S8ZiV6Kwo/images/add-ons/atarim-tasks-widget.png?fit=max\&auto=format\&n=j2Qcsx2S8ZiV6Kwo\&q=85\&s=8312ad3bfffc734f2941d6f97f3e37ee)
* **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 ![Atarim pro reports settings](https://mintcdn.com/mainwp/2rlXQ4CNzTqDCqtT/images/add-ons/3e3c796fdd7f.png?fit=max\&auto=format\&n=2rlXQ4CNzTqDCqtT\&q=85\&s=41231076c98e150af119eafdc65c5e4b)
  * 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

**1. Go to WP Admin > Settings > Permalinks page**

**2. 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) ![How Can I Enable MainWP REST API? 1](https://mintcdn.com/mainwp/j2Qcsx2S8ZiV6Kwo/images/add-ons/atarim-permalink-settings.jpg?fit=max\&auto=format\&n=j2Qcsx2S8ZiV6Kwo\&q=85\&s=1a08cba303f9b3412cef68a3ee676bec)

**3. Go to MainWP Dashboard > API Access > API Keys > Add API Keys page**

**4. Create an API key and enable MainWP REST API v1 Compatibility**

**5. Copy Consumer Key and Consumer Secret**

Click **Show Legacy API Credentials**, then copy Consumer Key and Consumer Secret. ![Enable REST API in MainWP](https://mintcdn.com/mainwp/9Fi7dKBCIriTb92d/images/add-ons/23ee66b7b918.png?fit=max\&auto=format\&n=9Fi7dKBCIriTb92d\&q=85\&s=d8ce9476665b608180ae43c57cf518e0)

**6. Click Save Key**

**7. Go to Atarim Dashboard > Settings > Integrations Settings page**

**8. Find the MainWP Integration section**

**9. 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 ![Enable MainWP & Atarim integration in your Atarim account](https://mintcdn.com/mainwp/j2Qcsx2S8ZiV6Kwo/images/add-ons/atarim-mainwp-integration.png?fit=max\&auto=format\&n=j2Qcsx2S8ZiV6Kwo\&q=85\&s=8ab098183c0d30c4780a7fded847bebf)

After connecting with MainWP, Atarim will display the **number of available updates, a number of security issues,** and the **uptime status** of the sites. ![Site info](https://mintcdn.com/mainwp/j2Qcsx2S8ZiV6Kwo/images/add-ons/atarim-site-status.png?fit=max\&auto=format\&n=j2Qcsx2S8ZiV6Kwo\&q=85\&s=465aef44927a8aa7cefe69d3fad5b2dd) ***Learn more about the [Atarim Integration](https://mainwp.com/extension/atarim/)!***

## How to disable Atarim on the Manage Sites table

### How to hide the Atarim column

**1. Go to MainWP Dashboard > Sites > Manage Sites page**

**2. Click the Cog icon (Page Settings) in the top right**

**3. De-select Atarim in the Show Columns section**

De-select Atarim in the **Show Columns** section ![Remove Atarim column from the Manage Sites table.](https://mintcdn.com/mainwp/j2Qcsx2S8ZiV6Kwo/images/add-ons/atarim-hide-column.gif?s=04cc07bc2ac86b33a3f18448332f6b30)

**4. Click the Save Settings button**

### How to unset the Atarim column

Insert the following snippet using our [Custom Dashboard Extension](https://mainwp.com/extension/mainwp-custom-dashboard-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;
}

```

![Custom Dashboard, PHP code snippet](https://mintcdn.com/mainwp/j2Qcsx2S8ZiV6Kwo/images/add-ons/atarim-custom-dashboard-snippet.png?fit=max\&auto=format\&n=j2Qcsx2S8ZiV6Kwo\&q=85\&s=0c2e6a84298c526724cc85d44b93a568)

***

## Related Resources

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


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.