MoonitorMoonitor
Browse documentation

Bulk import

Adding a whole fleet one form at a time gets old fast. Fill in a spreadsheet instead — Moonitor shows you exactly what it will create before anything is saved.

How it works

Bulk import lives at Monitors → Bulk add. You download a template, fill in one row per monitor, and upload it. Moonitor reads the sheet and shows a preview: which rows will be created, which will be skipped and why, and how many monitors you’ll have afterwards. Nothing is written until you press Import.

Imported monitors are ordinary monitors. They start checking straight away, they inherit your existing alert contacts, and you can edit or pause them like any other.

Import a spreadsheet

  1. Download the template

    Take the Excel version if you can. It has drop-downs on every fixed-choice column, a worked example of each monitor type on an Examples sheet, and a Reference sheet describing every column. A CSV version is available if you’d rather build the file from a script or export.

  2. Fill in one row per monitor

    Type your monitors into the Monitors sheet, starting at row 2. Every row needs a Name and a Type; what else is required depends on the type — see what each type needs. Leave a column blank to accept its default.

  3. Upload it

    Drop the file onto the upload area, or click to browse. Moonitor reads it immediately — this reads the file only, it doesn’t create anything.

  4. Review the preview

    Check the rows marked to be created, and read the reason beside any row that will be skipped. Fix anything you want to change in the spreadsheet and upload it again.

  5. Import

    Press Import. The monitors are created and begin checking on the schedule you gave them.

What each type needs

Every monitor needs a Name and a Type. Beyond that, each type has its own required column — the thing it’s meant to watch. For what each check actually does, see Monitor types.

TypeAlso requiredNotes
HTTPURLFull URL incl. https://
KEYWORDURL, KeywordWe fetch the page and check for a keyword
PINGHostHostname or IP address
PORTHost, PortHostname or IP, plus a port
CRONPush monitor — ping a URL we give you
DNSURLHostname to resolve
SSLURLWe check certificate expiry
DOMAINURLDomain registration expiry via RDAP

Tip

Columns that don’t apply to a row’s type are ignored, so you can copy a row and change its type without clearing out the leftovers. A Keyword sitting on an HTTP row is simply not read.

Every column

The same list is on the Reference sheet of the Excel template, and in the guide on the import page itself.

ColumnApplies toAccepted valuesIf left blank
NameAll typestextrequired
TypeAll typesHTTP, KEYWORD, PING, PORT, CRON, DNS, SSL, DOMAINrequired
URLHTTP, KEYWORD, SSL, DOMAIN, DNStextrequired
HostPING, PORTtextrequired
PortPORTwhole number 1–65535required
Check every (seconds)All typeswhole number 30–86400300 (5 minutes)
Timeout (seconds)All typeswhole number 1–6030
HTTP methodHTTP, KEYWORDGET, HEAD, POST, PUT, PATCH, DELETEGET
Accepted status codesHTTP, KEYWORDcodes separated by commasthe usual 2xx and 3xx codes
Request headersHTTP, KEYWORD"Name: value" per linenone
Request bodyHTTP, KEYWORDtextnone
Follow redirectsHTTP, KEYWORDyes / noyes
Verify SSLHTTP, KEYWORDyes / noyes
KeywordKEYWORDtextrequired
Keyword matchKEYWORDEXISTS, NOT_EXISTSEXISTS
DNS record typeDNSA, AAAA, CNAME, MX, TXT, NSA
DNS expected valueDNStextnone
Alert on DNS changeDNSyes / noyes
SSL expiry warning (days)SSLwhole number 1–3652
Expected heartbeat (seconds)CRONwhole number 60–2592000the check interval
Heartbeat grace (seconds)CRONwhole number 0–8640060

Rules and limits

File formats

Moonitor reads .xlsx and .csv files, up to 2 MB and 1,000 monitors per upload.

Heads up

Old-style .xls files (Excel 97–2003) can’t be read. Open the file and use File → Save As to save it as .xlsx or .csv, then upload that.

Rows that can't be imported

A row with a problem — a missing URL, an unknown type, a value out of range — is listed in the preview with the reason and skipped. The rest of the sheet still imports, so one bad row doesn’t hold up the other forty-nine. Fix it and upload again.

Your plan's limits apply

Import is subject to the same limits as adding monitors by hand — the monitor cap, the monitor types your plan includes, and the fastest check interval it allows. See Plans & billing.

  • A row using a type your plan doesn’t include, or an interval faster than it allows, is skipped with an explanation.
  • If the sheet as a whole would take you past your monitor cap, the import is refused rather than partly applied — we won’t create the first few rows and quietly drop the rest. Remove some rows or upgrade, then upload again.

Tidier sheets

Headers are matched loosely, so capitalisation, spacing and punctuation don’t matter. Blank rows are ignored, a title row above your headers is fine, and columns Moonitor doesn’t recognise are listed in the preview and skipped rather than treated as an error — handy if your sheet also carries your own notes or owner columns.