Use misomoon Cloud

misomoon Cloud is misomoon hosted for you at app.misomoon.com. It runs the same MIT-licensed code as this repository. You sign up, add the script tag to your site, and read the dashboard. We deploy, update, and monitor the Worker and its databases. To run misomoon in your own Cloudflare account instead, see Run misomoon in your Cloudflare account.

#Sign up and track your first site

1. Open app.misomoon.com/?signup, or select Start free trial on misomoon.com.
2. Enter your name, email, and a password of 10 characters or more, then select Create account.
3. Add your site and pick the region for its numbers. You can't change the region later.
4. Copy the script tag that the dashboard shows into the <head> of your pages.

The first pageview shows up in Live within a few seconds. Track your site covers custom events, revenue, and goals.

#Plans

Every plan has every feature, including revenue by source, click maps, form drop-off, JavaScript errors, Web Vitals, funnels, email reports, teams, the MCP server, and the API. Plans differ in how many events they include each month, how long a site can keep its stats, and how many sites a team can have:

Prices are on misomoon.com/pricing. An event is a pageview or a custom event. A pageview is one page that a visitor opens, including a page change in a single-page app. The beacons that add time on page and scroll depth to a pageview are not events. A plan counts the events of all the team's sites together.

A plan belongs to a team, not to a person (Work with your team). Each team has its own plan, and Settings > Team shows it: the plan, the sites the team has and the sites it includes, how long its sites keep stats, and this month's events against the events a month it includes.

#Pick or change a plan

A team's owners and billing members choose, switch, and cancel its plan in Settings > Team, and pay by card through Polar (Pay for misomoon Cloud). For more events than Scale includes, email support@misomoon.com.

#Add a site at the site limit

A team that has all the sites its plan includes can't add another site, or take one in from another team. The dashboard shows which plan the team is on and how many sites it includes. The API answers 403 with the code plan_site_limit (Errors). To make room, delete a site, move one to another team, or choose a bigger plan in Settings > Team (Pay for misomoon Cloud). Sites you are a guest on belong to another team and don't count.

#Move to a smaller plan

A move to a smaller plan deletes no site and changes no setting:

• With more sites than the new plan includes, the team keeps them all. It can't add or take in a site until it has fewer than the plan includes.
• With a shorter limit for stats, the next daily cleanup, at 03:15 UTC, deletes the visits, events, and payments older than the new limit. Each site's Keep stats for stays as it was, and applies again if the team moves back up. Export what you want to keep first (Take your data with you).
• With more events this month than the new plan's stop, 125% of its events, recording stops as soon as the new plan applies and starts again when the next month starts (Go past your monthly events). The switch dialog in Settings > Team says so before you switch.

#Go past your monthly events

A plan counts the events of the team's sites per calendar month in UTC, from the 1st at 00:00 UTC. A team past its plan's events keeps recording for a while, then stops:

• At 80% and at 100% of the plan's events, the team's owners, admins, and billing members get an email, once each per month.
• At 125%, misomoon stops recording the team's pageviews and custom events until the next month starts, or until the team moves to a plan with room. The same people get one email when that happens, and the dashboard shows a banner. On Starter the stop is at 125,000 events, on Growth at 1,250,000, and on Scale at 6,250,000. Each server checks the count about once a minute, and events already on their way are still recorded, so a busy month can end a little past 125%.
• A move to a bigger plan starts recording again within a minute. The emails start over for the new plan.

While recording is stopped, the dashboard and the API still show every number recorded so far, and payments from your payment provider's webhooks are still recorded. A payment whose visit came after the stop has no source. A pageview that misomoon didn't record doesn't come back later.

The count covers the sites the team has now. A site moved to another team mid-month takes its events for the month with it.

The daily ingest cap is a separate guard against bot floods and broken scripts. When support sets one on a site, the site stores at most that many events per UTC day, drops the rest until 00:00 UTC, and the team's owners and admins get one email the first time a day fills up (Daily ingest cap).

#Try it free for 7 days

Your first team starts with a 7-day trial of every feature, with Growth's limits: 1,000,000 events a month, stats kept for up to 3 years, and any number of sites. The trial needs no card. Settings > Team shows the days left, and a banner shows in the last 2 days. misomoon sends no email when the trial ends.

Each person gets one trial. It starts with the first team you create: the one sign-up makes, or the one misomoon makes when you add your first site. A team you create after that starts without a trial, so it needs a plan before it can add a site. A team you join by invitation runs on its own trial or plan.

When the trial ends, pick a plan for the team (Billing). Until it has one, the team has lapsed:

• misomoon stops recording its sites' pageviews and events.
• It can't add a site, or take one in from another team. The API answers 403 with the code plan_required (Plan limits).
• The dashboard stays readable and its settings stay editable. Its stats are kept for as long as each site's Keep stats for says, within the trial's 3 years, and you can export them at any time.
• Payments from your payment provider's webhooks are still recorded.

To pick a plan, open Settings > Team and choose one in the Plan card (Pick or change a plan). A plan starts recording again within a minute. Your sites, settings, and the numbers from the trial stay.

#Where your data lives

Each site keeps its statistics in Cloudflare D1 databases in the region you pick when you add it: the European Union, the United States, or Asia-Pacific. Account data, site settings, and the daily salts are stored in the European Union. Tracker requests are answered by the Cloudflare data center nearest the visitor.

Our data processing agreement covers the data on misomoon Cloud. Read the privacy policy for the account data we keep about you, and Compliance for what misomoon collects about your visitors.

#How long your numbers are kept

misomoon Cloud keeps a site's visits, events, and payments for 25 months by default, then deletes them once a day as they pass that age. On Starter, the default is 2 years, which is the longest Starter keeps. To keep them longer or shorter, change Keep stats for in Settings > Install > Privacy, from 30 days up to your plan's longest: 2 years on Starter, and 3 years on Growth and Scale. The list offers only what your plan allows, and the API refuses a longer retention_days with the code plan_retention_limit. History you imported from Google Analytics or CSV files is not deleted. Privacy settings has the details, and Take your data with you explains how to export before the limit.

25 months is the longest the French regulator, the CNIL, allows for audience measurement without consent. Keeping stats for longer goes past that limit, so a site with visitors in France may then need consent (Do you need a consent banner?). Any site can set a shorter period. On your own server there is no limit until you set one (Configuration).

#Take your data with you

Export any period as a ZIP of CSV files from the dashboard, on any plan. To move to your own instance, deploy misomoon to your Cloudflare account and upload those files with Bring your history.

#Choose between Cloud and self-hosting