Getting started

Getting started overview

This overview helps you reach your first tracked link quickly.

What you will set up

Sign in to your account.
Use the default workspace or create a new one.
Create a collection for your first campaign.
Create a link and share it.
Open Analytics to confirm clicks.

Recommended order

Review your profile name and avatar.
Rename the workspace if needed.
Create a collection for the project.
Create a link with a destination.
Check Analytics after sharing.

Access is collection-based. If you cannot see a collection, ask an owner for access.

Create an account

Create an account to access your dashboard and workspaces.

Where to find it

Homepage → Sign up

Steps

Open the sign up page.
Enter your email address.
Enter the one-time code sent to your email.
Complete account setup to reach the dashboard.

Notes

Use an email address that you can access. Hoko sends sign-in codes to this address.
Your first workspace is created automatically on the first sign-in.

If you already have an account, use Sign in.

Where to find it

Homepage → Sign in

Steps

Open the sign in page.
Enter your email address.
Enter the one-time code sent to your email.
Arrive at your dashboard.

Notes

The last used workspace is selected automatically.
You can switch workspaces from the switcher later.

Request a new one-time code if the previous code expires.

Sign out

Sign out to end your current session.

Where to find it

Account menu in the dashboard header

Steps

Open the account menu.
Select Sign out.
Confirm when prompted.

Notes

Signing out clears session cookies on this device.
You will need to sign in again to access the dashboard.

Signing out does not delete your data.

First workspace created automatically

If you sign in for the first time and you do not have any workspaces, Hoko creates one for you.

What is created

A workspace named Default Workspace.
A default collection named Links.
You are assigned the owner role.

What to do next

Rename the workspace to match your project.
Create additional collections as needed.
Update your profile and workspace images.

This happens only when no workspaces exist on your account.

Workspace switching behavior

Switching workspaces changes which collections and links you can access.

How switching works

Use the workspace switcher in the dashboard header.
The selection is stored in cookies.
If the current collection is not available, the default collection is selected.

What changes

Visible links and collections.
Analytics scope.
Default collection in forms.

If you lose access to a collection, another accessible collection is selected automatically.

Role model explained

Workspace and collection roles control different parts of your access.

Roles

Owner: full workspace access, including billing and ownership transfer.
Workspace Admin: manage workspace operations and integrations, except billing and ownership.
Collection Admin: manage assigned collections and their member roles.
Editor: create and edit links in assigned collections.
Viewer: read assigned collection data.
No access: no collection role is assigned.

Scope

Collection roles are assigned separately for each collection. You can be a Viewer in one and an Editor in another. See Access and permissions for the full role matrix.

Owners and Workspace Admins can change workspace settings. Billing and ownership remain Owner-only.

Troubleshooting

Use these checks when the dashboard does not load or access is missing.

Missing dashboard access

Sign in again to refresh your session.
Verify you are a member of a workspace.
Ask an owner to send a new invite.

Workspace not found

Open the workspace switcher and choose another workspace.
Clear cookies and sign in again.
Contact a workspace owner to confirm membership.

Session expired

Reload the page.
Sign in again if needed.