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 and password.
- Complete email verification if prompted.
- Sign in to reach the dashboard.
Notes
- Use a real email address that you can access.
- Your first workspace is created automatically on the first sign-in.
If you already have an account, use Sign in.
Sign in
Sign in to access your workspaces and collections.
Where to find it
- Homepage → Sign in
Steps
- Open the sign in page.
- Enter your account credentials.
- Complete any verification step.
- Arrive at your dashboard.
Notes
- The last used workspace is selected automatically.
- You can switch workspaces from the switcher later.
Use the password reset flow if you cannot sign in.
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
Roles control what you can do inside each collection.
Roles
- Owner: full access including workspace settings and member management.
- Admin: manage collections and content, invite members.
- Editor: create and edit links, tags, partners, and templates.
- Viewer: read-only access to links and analytics.
- No access: the collection is hidden.
Scope
Roles are assigned per collection. You can be a viewer in one collection and an editor in another.
Only owners can change workspace identity settings.
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.