Help & guidesAdvanced monitors › Bulk import monitors via CSV

Bulk import monitors via CSV

4 min read · Advanced monitors

Bulk import of monitors via CSV

4 min read

If you are migrating from another uptime tool or have 20+ websites, manual adding is a waste of time. Bulk import uploads a CSV file and creates dozens of monitors at once.

CSV format

name,type,target,interval_minutes,expected_status,expected_keyword,tags
"Main page",https,https://www.company.com,5,200,"Welcome",production
"API health",https,https://api.company.com/health,1,200,"\"status\":\"ok\"",api
"DB server",tcp,db.company.com:5432,5,,,production
"Email MX",dns,company.com,30,,,email

Columns:

  • name - required, max 120 characters
  • type - required, one of: http, ssl, tcp, dns, heartbeat, visual, lan_ping, lan_tcp, lan_http
  • target - required, URL / hostname / IP:port
  • interval_minutes - optional, default 5 (limit depends on plan)
  • expected_status - optional, HTTP status code (default 200)
  • expected_keyword - optional, string in the body
  • tags - optional, comma-separated tags (max 8)

Procedure

  1. Open the dashboard, Add monitor, the Bulk import tab.
  2. Download the CSV template (correct columns + UTF-8 BOM).
  3. Fill in Excel / Google Sheets / a text editor. Save as CSV (UTF-8).
  4. Upload via the "Select file" button. The preview shows the first 20 rows + errors.
  5. If everything is OK, press "Import X monitors".

Mind the limits: if you exceed the number of monitors in your plan, the import fails. The current state is visible in the top left corner of the dashboard (X / Y monitors).

Tips

  • For expected_keyword with quotes, use double escape: "\"status\":\"ok\""
  • Separate tags with commas: production,critical (the CSV separator is also a comma - wrap the whole cell in quotes)
  • After import, all monitors start checking within a minute