{"slug":"exporting-a-list-of-tailnet-users","title":"Exporting a list of tailnet users","tags":["tailscale"],"agent_summary":"Last validated: Jan 5, 2026","trigger_phrases":[],"runnable":false,"markdown":"\r\n# Exporting a list of tailnet users\r\n\r\nLast validated: Jan 5, 2026\r\n\r\nUsing the [Users](https://login.tailscale.com/admin/users) page in the admin console, you can export a list of users in your\r\ntailnet. You can choose to download a list of all users, or you can filter by criteria to download a\r\nsubset of users. Example of data in the download is user name, whether the user is active, when the user was last active.\r\n\r\nThe download file is in comma-separated values (CSV) format, which is recognized by many browsers\r\nand spreadsheet programs. Each row in the CSV file represents one user.\r\n\r\nIf you want to know how to export a list of devices, refer to [Exporting a list of tailnet devices](https://tailscale.com/docs/features/access-control/device-management/how-to/export-list).\r\n\r\n## [Exporting a list of users](https://tailscale.com/docs/features/sharing/how-to/export-list\\#exporting-a-list-of-users)\r\n\r\nYou need to be an [Owner, Admin, Network admin, IT admin, or Auditor](https://tailscale.com/docs/reference/user-roles) of a tailnet in order\r\nto access the admin console and export a list of users.\r\n\r\n1. Open the [Users](https://login.tailscale.com/admin/users) page in the admin console.\r\n2. (Optional) Select **Status** and/or **Role** to filter which users you want to list.\r\n3. Select the download icon at the top right of the page. This opens the **Export users data to CSV** dialog.\r\n4. If you have selected any filters, you have the option of either downloading all users or the subset\r\nof users selected by the filter.\r\n5. Select **Download**.\r\n\r\nIf your browser settings let you specify a file name:\r\n\r\n1. Specify the name of the file to use for the download, or accept the default name.\r\n2. Go to the location where you want to save the file.\r\n3. Select **Save**.\r\n\r\nIf your browser settings instead automatically download the file, look for it in the\r\nDownloads folder. The file name is of the form:\r\n\r\n```markup\r\n-users-.csv\r\n```\r\n\r\nwhere:\r\n\r\n- `` is your [tailnet ID](https://tailscale.com/docs/concepts/tailnet-name#tailnet-id).\r\n- `` is the date and time the exported list was generated.\r\n\r\nFor example:\r\n\r\n```markup\r\nexample.com-users-2022-12-14T20-20-47-018Z.csv\r\n```\r\n\r\n## [Limitations](https://tailscale.com/docs/features/sharing/how-to/export-list\\#limitations)\r\n\r\n- The download is a point-in-time export based on the time that the download occurred. You cannot\r\nspecify an earlier time to capture historical data.\r\n- You cannot select which columns to export.\r\n- Columns may change as we add or update features.\r\n\r\n![Project Logo](https://cdn.brandfetch.io/tailscale.com/fallback/lettermark/theme/dark/h/256/w/256/icon?c=1bfwsmEH20zzEfSNTed)\r\n\r\nAsk AI\r\n\r\nreCAPTCHA\r\n\r\nRecaptcha requires verification.\r\n\r\nprotected by **reCAPTCHA**\r\n","html":"

Exporting a list of tailnet users

\n

Last validated: Jan 5, 2026

\n

Using the Users page in the admin console, you can export a list of users in your\r\ntailnet. You can choose to download a list of all users, or you can filter by criteria to download a\r\nsubset of users. Example of data in the download is user name, whether the user is active, when the user was last active.

\n

The download file is in comma-separated values (CSV) format, which is recognized by many browsers\r\nand spreadsheet programs. Each row in the CSV file represents one user.

\n

If you want to know how to export a list of devices, refer to Exporting a list of tailnet devices.

\n

Exporting a list of users

\n

You need to be an Owner, Admin, Network admin, IT admin, or Auditor of a tailnet in order\r\nto access the admin console and export a list of users.

\n
    \n
  1. Open the Users page in the admin console.
    2. \n
  2. (Optional) Select Status and/or Role to filter which users you want to list.
    3. \n
  3. Select the download icon at the top right of the page. This opens the Export users data to CSV dialog.
    4. \n
  4. If you have selected any filters, you have the option of either downloading all users or the subset\r\nof users selected by the filter.
    5. \n
  5. Select Download.
    6. \n
\n

If your browser settings let you specify a file name:

\n
    \n
  1. Specify the name of the file to use for the download, or accept the default name.
    2. \n
  2. Go to the location where you want to save the file.
    3. \n
  3. Select Save.
    4. \n
\n

If your browser settings instead automatically download the file, look for it in the\r\nDownloads folder. The file name is of the form:

\n
<organization-name>-users-<date-time>.csv\n
\n

where:

\n
    \n
  • <organization-name> is your tailnet ID.
    • \n
  • <date-time> is the date and time the exported list was generated.
    • \n
\n

For example:

\n
example.com-users-2022-12-14T20-20-47-018Z.csv\n
\n

Limitations

\n
    \n
  • The download is a point-in-time export based on the time that the download occurred. You cannot\r\nspecify an earlier time to capture historical data.
    • \n
  • You cannot select which columns to export.
    • \n
  • Columns may change as we add or update features.
    • \n
\n

\"Project

\n

Ask AI

\n

reCAPTCHA

\n

Recaptcha requires verification.

\n

protected by reCAPTCHA

\n"}