Skip to main content

Create your first property

A property is the site, app, or product surface you want to track. Each property has its own analytics dashboard, installation credentials, team access, reports, and ingestion controls.

Create property

Create a property​

  1. Open the Nexly dashboard.
  2. Choose New property.
  3. Enter a clear property name.
  4. Add a Site URL when you track a website in the browser. Skip this field if you only use mobile or backend SDKs and have already enabled Mobile apps or Backend under SDK options (see below).
  5. Under SDK options, enable Mobile apps and/or Backend when you plan to send events from those channels (see SDK options below).
  6. Upload an avatar if you want the property to be easier to recognize.
  7. Continue to Install SDK.

Nexly creates an App ID and ingest key for the property automatically.

The same flow works for every property after the first one: click the + button next to the Dashboard title, and the new property waits under New apps until its first event arrives.

Add another property with the plus button on the home dashboard

SDK options​

Web traffic is tied to allowed origins such as your Site URL. Mobile and server-side SDKs use separate ingestion channels, so you turn them on explicitly:

When Mobile apps or Backend is enabled, the Site URL field in the wizard is optional — you can finish setup without a browser origin and send the first event from a mobile app or server SDK instead. Web events still require a matching allowed origin before they are accepted.

You can change these any time under Settings → Ingest. Enable only the channels you actually use. Not sure which SDK fits your stack? Start with Choose an SDK.

Complete the setup wizard​

The setup wizard walks through the first-time checklist:

  • Basics: name, avatar, site URL (optional when mobile or backend SDK is enabled), and SDK options.
  • Install SDK: choose how to install Nexly and send the first event. See Choose an SDK.
  • Invite team: add teammates when you are ready. See Team roles and access.
  • All set: finish setup and open the dashboard.

The property may redirect back to setup until the wizard is complete.

On the Install SDK step, choose AI agent. Nexly generates a ready-to-paste prompt with this property's App ID and ingest key already filled in.

Copy the prompt and paste it into Cursor, Claude Code, Codex, or any coding agent that can read your repository. The prompt tells the agent to:

  • Pick the right @nexly/* package for your stack (browser, React, Next.js, React Native, or Node.js). See Choose an SDK for a quick comparison.
  • Install the SDK with your project's package manager.
  • Wire up the client or provider using the credentials from the prompt.
  • Keep the ingest key out of the browser bundle when possible (for example via an environment variable).

You do not need to copy snippets by hand or guess which SDK fits your codebase — hand the prompt to your agent and let it make the changes. When it finishes, follow whatever it tells you on your side (set an env var, restart the dev server, deploy, or open a page to fire a pageview).

Prefer to install yourself? Switch to Manual, pick your framework, and copy the step-by-step instructions instead — Script tag, Web and React, or Next.js, React Native, and Node.js.

Verify the first event​

After you install an SDK, open your app and trigger a pageview, screenview, or backend event. The setup page waits for the first event and then marks the property as connected. See Automatic events for what Nexly records out of the box.

If no event arrives:

  • Confirm the App ID and ingest key match the property.
  • For web apps, confirm the domain is listed under Settings → Ingest → Allowed origins. See Ingest settings.
  • For React Native or Node.js, confirm Mobile apps or Backend is enabled under Settings → Ingest — a browser Site URL is not required for those channels. See SDK traffic sources.
  • Make sure ingestion is not paused.
  • Check that an ingest filter is not blocking your current IP, country, page, or screen.

Next steps​

Open the property dashboard and review the visitors chart, headline metrics, and events feed. See the Dashboard tour. Invite teammates once you have confirmed the property is receiving data.