## **🔍 Before you begin**

\*\* Make sure you can access and edit the relevant OTTO project in Search Atlas and create a Cloudflare user API token with the required permissions for the website’s Cloudflare account and zone. Confirm that the website is active in Cloudflare and its DNS is managed there.

## **⚙️ Create a Cloudflare API token**

1. Sign in to Cloudflare and open your profile.
2. Go to **API Tokens** and select **Create Token**.
3. \*\* On the Cloudflare user API Tokens page, select the Edit Cloudflare Workers template. Add Zone → DNS → Edit, and scope the token to the Cloudflare account and zone for your website. Review the template’s Workers permissions before creating the token.
4. Limit the token to the specific website zone whenever possible.
5. Create the token and copy it immediately. Cloudflare will not show the full token again.

## **🔗 Connect Cloudflare in Search Atlas**

1. Open the relevant project in Search Atlas.
2. Open the OTTO settings or installation section.
3. Select **Cloudflare** as the connection method.
4. \*\* In the Cloudflare installation section of the relevant OTTO project, paste the Cloudflare user API token into the Paste your API Token field.
5. Submit the connection details and wait for the verification result.

\*\* Make sure you opened the OTTO project for the intended website and that the token is scoped to its Cloudflare account and zone. Paste the token without extra spaces.

## **✅ Verify the connection**

\*\* After the process finishes, confirm that Cloudflare shows Connected in the OTTO installation guide. Check the installation or diagnostics results, then visit the website in an incognito browser window to confirm that it loads normally before publishing OTTO changes.

## **🛠️ Troubleshoot connection problems**

- \*\* Invalid token: Check that you created a Cloudflare user API token—not an account API token—and that it includes the Workers permissions from the Edit Cloudflare Workers template plus Zone → DNS → Edit. Confirm that its account and zone scope includes your website. If necessary, create a new token and paste it again.
- \*\* Zone not found: Confirm that the website domain in your OTTO project belongs to a zone in the Cloudflare account and that the token includes access to that account and zone.
- **Permission denied:** Ask a Cloudflare account administrator to create the token or grant the required permissions.
- **Changes are not visible:** Check that the correct Cloudflare zone is connected and allow time for caching to update.
- **Website errors after connection:** Temporarily review Cloudflare caching, security, and firewall rules, then confirm that the site still loads without OTTO changes.

## **💬 Get help with your setup**

Support availability can vary by plan and day. If you need further assistance, open the chat widget in the bottom-right corner of the platform and send your message. A member of our support team will reply in the chat.