Microsoft Clarity Webflow Integration Setup
A recurring point of confusion when setting up Microsoft Clarity on client sites is the pending project admin approval step that appears on the Shopify or Webflow side after installing the plugin. This article documents the correct workflow and where the approval actually lives.
The Approval Blocker
When a developer installs the Clarity plugin on a Shopify or Webflow site, they may see a message like:
"Project link request is sent to Clarity Project ID [xxx] — pending project admin's approval."
This approval request is sent via email to whichever account owns the Clarity project — in Asymmetric's case, the shared team@ account. It does not surface as a notification inside the Clarity UI itself, which is why it's easy to miss.
Fix: Log into the team@ email account, find the approval email, and click the approval link. Once approved, the Clarity plugin will show as successfully installed.
Setup Steps (Webflow)
- In Microsoft Clarity, create a new project and select Webflow as the platform.
- Clarity will walk you through the installation steps.
- After the developer installs the tracking code or plugin, watch for an approval email arriving at the
team@account. - Approve the request from the
team@inbox. - Clarity will confirm successful installation. Note that data takes 2–3 days to begin appearing.
Setup Steps (Shopify)
- In Microsoft Clarity, open the existing project and go to Getting Started → Install.
- Copy the Project ID (not a full code snippet).
- Have the developer install the Clarity app from the Shopify App Store and paste the Project ID into the app settings.
- After saving, the Shopify side will send a project link request to the Clarity project owner — again, the
team@account. - Approve from
team@. Clarity will confirm installation.
Adding Client Users
Once the project is live, clients can be invited to view their own Clarity data without needing access to the team@ account:
- In Clarity, go to Settings → Team.
- Click Add Team Member and enter the client's email address.
- The client will receive an invitation to join the project.
Example: For PaperTube,
parag@papertube.cowas invited as a team member so Parag could access session recordings and heatmaps directly.
Key Gotcha
The Clarity UI does not show a pending approval notification anywhere inside the dashboard. There is no "approvals" queue to check. The only place the approval request appears is in the email inbox of the project-owning account (team@). Always check there first if an integration appears stuck.
Related
- [1] — first client where this approval flow was encountered
- [2] — next site to receive Clarity setup via this workflow