V4 Admin

# Users

/dashboard/users

At Dashboard Users you can administer all the users in the system.

# Listing

Users are displayed as a grid where each card shows the user's profile image (or background image), their username, and the number of files uploaded.

# Sorting

Use the Top dropdown to change the listing order. Available options are Top, Most recent, Oldest, Most viewed, Most liked, and AZ.

# Create user

Click the + Create user button (top right) to create a new user account. The form requires the following fields:

  • Role — The user's permission level: User, Manager, or Administrator.
  • Username — The unique handle for the new account.
  • Email — The email address associated with the account.
  • Password — The initial password for the account.

# User edit

Click on any user card to go to their profile, where additional admin actions are available. From there click Settings to open the full edit page at /dashboard/user/{id}.

# Account tab

Displays read-only information about the user and provides editable account settings.

Read-only info:

  • Username — Current username with a Delete user button to permanently remove the account.
  • User ID — Internal numeric ID and its short encoded form.
  • Images — Total number of files uploaded by the user.
  • Albums — Total number of albums created.
  • Register date — Account creation date shown in local time and UTC.
  • IP Address — Registration IP with Search (find other content from this IP) and Ban (add the IP to the ban list) actions.

Editable settings:

  • Status — Account state: Valid, Banned, Awaiting email, or Awaiting confirmation.
  • Role — User, Manager, or Administrator.
  • Username — The user's handle (URL preview shown below the field).
  • Email address — Contact email for the account.
  • Auto delete uploads — Automatically delete uploaded files after a set period, from 5 minutes up to 1 year. Applies as the default for all uploads; can be overridden per upload.
  • Keep EXIF data — Preserve EXIF metadata on upload.
  • Automatic metadata tags — Assign the camera model as a tag on upload.
  • Newsletter — Opt in or out of Chevereto news emails.
  • Show not safe content — Whether the user sees not-safe content in listings from others.
  • Language — Interface language for the account (supports 40+ locales).
  • Timezone — User timezone by region and city.

Click Save changes to apply.

# Profile tab

/dashboard/user/{id}/profile

Manage the user's public identity.

  • Avatar — Upload a new avatar image or delete the existing one.
  • Privacy — Toggle to make the profile and identity fully private.
  • Name — Display name shown on the public profile.
  • Website — URL linked from the profile.
  • Bio — Short description shown on the public profile.

# Password tab

/dashboard/user/{id}/password

Set or replace the user's password. If the user has no password (e.g. registered via a login provider), a notice is shown. Enter the new Password and Confirm password, then click Save changes.

# Security tab

/dashboard/user/{id}/security

Manage two-factor authentication (2FA) for the account. A QR code is provided to scan with any TOTP authenticator app. Enter the OTP code generated by the app and click Submit to enable 2FA.

# API tab

/dashboard/user/{id}/api

View and manage the user's API key for programmatic access to Chevereto.

  • API key — The current key is shown masked. Use the copy button to copy it. The key is only displayed in full once at generation time.
  • Regen key — Generates a new API key, invalidating the previous one.

The tab also shows an example curl command for uploading files via the API.