# Hoko Help User-facing help pages for account setup, workspaces, links, analytics, billing, security, and API key management. Full help context: https://hoko.to/help/llms-full.txt ## Help Navigation ### Help - [Getting started](https://hoko.to/help/getting-started) - [Profile](https://hoko.to/help/profile) - [Workspaces](https://hoko.to/help/workspaces) - [Collections](https://hoko.to/help/collections) - [Links](https://hoko.to/help/links) - [Tags](https://hoko.to/help/tags) - [Partners](https://hoko.to/help/partners) - [UTM templates](https://hoko.to/help/utm-templates) - [Analytics](https://hoko.to/help/analytics) - [Participants](https://hoko.to/help/participants) - [API keys](https://hoko.to/help/api-keys) - [Billing](https://hoko.to/help/billing) - [Storage](https://hoko.to/help/storage) - [Security](https://hoko.to/help/security) ## Full Help Documentation ### Getting started Canonical URL: https://hoko.to/help/getting-started # 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 1. Review your profile name and avatar. 2. Rename the workspace if needed. 3. Create a collection for the project. 4. Create a link with a destination. 5. Check Analytics after sharing. > [!INFO] 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 1. Open the sign up page. 2. Enter your email and password. 3. Complete email verification if prompted. 4. 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. > [!INFO] 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 1. Open the sign in page. 2. Enter your account credentials. 3. Complete any verification step. 4. Arrive at your dashboard. ### Notes - The last used workspace is selected automatically. - You can switch workspaces from the switcher later. > [!INFO] 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 1. Open the account menu. 2. Select Sign out. 3. Confirm when prompted. ### Notes - Signing out clears session cookies on this device. - You will need to sign in again to access the dashboard. > [!INFO] 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 1. Rename the workspace to match your project. 2. Create additional collections as needed. 3. Update your profile and workspace images. > [!INFO] 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. > [!INFO] 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. > [!WARNING] 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. --- ### Profile Canonical URL: https://hoko.to/help/profile # Profile ## Update profile name Update the name shown in menus, invites, and activity. ### Where to find it - Dashboard → Settings → Profile ### Steps 1. Open Profile settings. 2. Edit your profile name. 3. Save the changes. ### Notes - Profile names must be 3–32 characters. - Names must be unique. > [!INFO] Your email address does not change. ## Update profile avatar Upload a new avatar image for your profile. ### Where to find it - Dashboard → Settings → Profile ### Steps 1. Open Profile settings. 2. Choose a new image file. 3. Wait for the upload to finish. 4. Save the changes. ### Notes - PNG, JPG, or SVG files only. - Maximum size is 2 MB. - The image is stored as a hashed file name. > [!INFO] If no avatar is set, initials are shown instead. ## Profile image rules Profile images follow these rules to keep storage consistent. ### Rules - Allowed types: PNG, JPG, or SVG. - Maximum file size is 2 MB. - File name uses a SHA256 hash and is stored as hash.png. - Storage path is avatar/{profileId}/hash.png. - The database stores only hash.png. ### Tips - Use a square image for best results. - Keep the file size small for faster upload. > [!INFO] The server builds the full image URL and sends it to the client. ## Troubleshooting Use these fixes when profile updates fail. ### Failed to update profile name - Check the 3–32 character length. - Ensure the name is unique. - Try saving again. ### Failed to update profile avatar - Confirm the file type is PNG, JPG, or SVG. - Keep the file under 2 MB. - Retry the upload. ### Invalid image type - Choose a PNG, JPG, or SVG file. - Avoid unsupported formats like GIF. ### Image size exceeds limit - Compress or resize the image. - Upload again after reducing size. --- ### Workspaces Canonical URL: https://hoko.to/help/workspaces # Workspaces ## Create a workspace Create a workspace to organize a new team or project. ### Where to find it - Workspace switcher in the dashboard header ### Steps 1. Open the workspace switcher. 2. Select Create a new workspace. 3. Enter a workspace name. 4. Confirm to create the workspace. ### Notes - A default collection named Links is created automatically. - You become the owner of the new workspace. - The new workspace becomes active right away. > [!WARNING] Creation is blocked if you reach the ownership limit. ## Workspace name rules Workspace names keep your switcher readable and organized. ### Rules - Name is required. - Maximum length is 32 characters. ### Examples - Marketing - Client A - Product Team ### Tips - Keep names short for easier switching. ## Workspace slug rules Workspace slugs appear in URLs and must be unique. ### Rules - Slug is required. - Length must be between 3 and 32 characters. - Slug must be unique across workspaces. ### Tips - Use lowercase letters, numbers, and hyphens for clarity. ## Update workspace name Update the workspace name to keep it recognizable in the switcher. ### Where to find it - Dashboard → Settings → Workspace ### Steps 1. Open Workspace settings. 2. Edit the workspace name. 3. Save the changes. ### Notes - Maximum length is 32 characters. ## Update workspace slug Update the workspace slug to change its URL identifier. ### Where to find it - Dashboard → Settings → Workspace ### Steps 1. Open Workspace settings. 2. Edit the workspace slug. 3. Save the changes. ### Notes - Slug length must be 3–32 characters. - Slug must be unique. ## Update workspace image Upload a new image to represent the workspace. ### Where to find it - Dashboard → Settings → Workspace ### Steps 1. Open Workspace settings. 2. Choose a new image file. 3. Wait for the upload to finish. 4. Save the changes. ### Notes - PNG, JPG, or SVG files only. - Maximum size is 2 MB. - The image is stored as a hashed file name. ## Workspace image rules Workspace images follow these rules to keep storage consistent. ### Rules - Allowed types: PNG, JPG, or SVG. - Maximum file size is 2 MB. - File name uses a SHA256 hash and is stored as hash.png. - Storage path is avatar/{workspaceId}/hash.png. - The database stores only hash.png. ### Tips - Use a square image for consistent avatars. - Keep the file size small for faster upload. ## Workspace ownership limits Workspaces have ownership limits to keep accounts manageable. ### Default limit - The default policy allows up to two owned workspaces per profile. ### What happens at the limit - Creating new workspaces is blocked. - You can still be invited to other workspaces. > [!INFO] Transfer ownership if you need to stay within the limit. ## Troubleshooting Use these fixes when workspace actions fail. ### Failed to create workspace - Check the workspace name length. - Confirm you have not reached the ownership limit. - Try again after refreshing. ### Workspace name rejected - Keep the name under 32 characters. - Avoid empty names. ### Workspace slug rejected - Use 3–32 characters. - Pick a unique slug. ### Failed to update workspace image - Use PNG, JPG, or SVG. - Keep the file under 2 MB. - Retry the upload. --- ### Collections Canonical URL: https://hoko.to/help/collections # Collections ## Collection concept A collection groups related links and controls access for each participant. ### Why it matters - Organize links by campaign, client, or product. - Control who can view or edit links. - Scope analytics to specific collections. ### How it connects - Every link belongs to one collection. - Participant roles are set per collection. > [!INFO] Collections keep access and analytics consistent across the workspace. ## Create a collection Create a collection to organize links in your workspace. ### Where to find it - Dashboard → Library → Collections ### Steps 1. Open Collections. 2. Select New collection. 3. Enter a collection name. 4. Create the collection. ### Notes - Names must be unique within the workspace. - Plan limits may apply. > [!INFO] Owners are granted access automatically. ## Collection name rules Collection names keep your library organized. ### Rules - Name is required. - Maximum length is 32 characters. - Names must be unique in the workspace. ### Tips - Use descriptive names that match your campaigns. ## Rename a collection Rename a collection to keep labels consistent. ### Where to find it - Dashboard → Library → Collections ### Steps 1. Open Collections. 2. Select Rename on a collection card. 3. Enter the new name. 4. Save the changes. ### Notes - Names must remain unique within the workspace. - Links stay in the same collection. ## Set default collection Choose which collection is selected by default. ### Where to find it - Dashboard → Library → Collections ### Steps 1. Open Collections. 2. Click Default on the chosen collection. ### Notes - The default button is disabled for the current default collection. - The default is used when switching workspaces. > [!INFO] If the default collection is removed, another collection is selected automatically. ## Remove a collection Remove a collection and its access from the workspace. ### Where to find it - Dashboard → Library → Collections ### Steps 1. Open Collections. 2. Select Remove on the collection card. 3. Confirm the removal. ### Notes - Links in the collection are removed from active views. - Members lose access to that collection. - The last remaining collection cannot be removed. > [!WARNING] Removal affects links, invites, and analytics for that collection. ## Troubleshooting Use these fixes when collection actions fail. ### Failed to create collection - Confirm you have permission to create collections. - Check name length and uniqueness. - Verify plan limits. ### Duplicate collection name - Choose a different name. - Search for existing collections with the same name. ### Failed to rename collection - Ensure the new name is unique. - Keep the name under 32 characters. ### Failed to set default collection - Try selecting another collection. - Refresh the page and retry. ### Failed to remove collection - Make sure it is not the only collection. - Confirm you have delete permissions. --- ### Links Canonical URL: https://hoko.to/help/links # Links ## Link concept A link is a short URL that redirects to a destination and tracks activity. ### Why it matters - Measure clicks, leads, and sales. - Organize links inside collections. ### How it connects - Each link belongs to one collection. - Links can include tags, partners, and UTM data. > [!INFO] Analytics are scoped to the collection that owns the link. ## Create a link Create a new link to share and track destinations. ### Where to find it - Dashboard → Links ### Steps 1. Open Links. 2. Select New link. 3. Enter the destination URL. 4. Choose a collection and optional settings. 5. Create the link. ### Notes - Destination URL and collection are required. - You can add tags, partners, or UTM data later. ## Required link fields Links require a few fields before they can be created. ### Required fields - Destination URL - Collection ### Optional fields - Short ID - Tags - Partner - UTM parameters - Comments - QR code - Targeting - Expiry rules > [!INFO] If you leave the short ID empty, a random one is generated. ## Edit a link Edit link details without losing historical analytics. ### Where to find it - Dashboard → Links ### Steps 1. Open Links. 2. Select a link from the list. 3. Edit the fields you need. 4. Save the changes. ### Notes - Edits apply immediately. - Past analytics remain tied to the link. ## Remove a link Remove a link so it no longer appears in the workspace. ### Where to find it - Dashboard → Links ### Steps 1. Open Links. 2. Select the link to remove. 3. Confirm deletion. ### Notes - Removed links no longer appear in lists. - Historical analytics remain available. ## Link filters Filters narrow the links list to what you need. ### Available filters - Tags - Collections - Destinations - Sort order ### How filters combine Multiple filters are applied together. Clear filters to return to the full list. ## Link search behavior Search scans key fields to help you find links fast. ### Search coverage - Link ID - Link name - Description - Short ID - Destination URL - Comments ### Search tips - Use partial keywords. - Search is case-insensitive. ## Link tags usage Tags help categorize links and improve filtering. ### When to use tags - Group links across collections. - Filter analytics by campaign or topic. ### How tags are applied Select tags when creating or editing a link. You can add or remove tags any time. > [!INFO] Tag changes apply immediately to filters and analytics views. ## Link partners usage Partners connect links to affiliates or collaborators. ### When to use partners - Track partner-driven traffic. - Attribute conversions to a partner. ### How partners are applied Select a partner when creating or editing a link. Partners are optional. ## Link UTM templates usage UTM templates fill tracking parameters quickly. ### When to use UTM templates - Reuse consistent UTM values across campaigns. - Reduce manual entry when creating links. ### How templates are applied Select a template in the link dialog to populate UTM fields. You can edit values after applying. ## Troubleshooting Use these fixes when link actions fail. ### Failed to create link - Check the destination URL. - Select an accessible collection. - Verify permissions. ### Invalid destination URL - Include the full URL with https://. - Avoid spaces or unsupported characters. ### Link not found - Clear filters and search again. - Verify you have access to the collection. ### Failed to update link - Check required fields. - Retry after refreshing the page. ### Failed to delete link - Confirm you have delete permission. - Try again after refreshing. ### Tag assignment failed - Check that the tag still exists. - Try removing and re-adding the tag. ### Partner assignment failed - Confirm the partner exists. - Retry after refreshing. --- ### Tags Canonical URL: https://hoko.to/help/tags # Tags ## Tag concept Tags label links so you can filter and analyze them easily. ### Why it matters - Filter links by campaign or theme. - Use tags to segment analytics. ### How it connects - Tags can be applied to any link. - Analytics filters can use tags. ## Create a tag Create tags to organize links and analytics. ### Where to find it - Dashboard → Library → Tags ### Steps 1. Open Tags. 2. Select New tag. 3. Enter a tag name and color. 4. Create the tag. ### Notes - Tag names must be unique. - If the name is empty, a short ID is generated. ## Update a tag Update tag names or colors to keep them consistent. ### Where to find it - Dashboard → Library → Tags ### Steps 1. Open Tags. 2. Select a tag. 3. Edit the name or color. 4. Save the changes. ### Notes - Names must stay unique. ## Remove a tag Remove a tag when you no longer need it. ### Where to find it - Dashboard → Library → Tags ### Steps 1. Open Tags. 2. Select Remove on the tag. 3. Confirm deletion. ### Notes - Removing a tag does not delete links. - Links will simply lose that tag. ## Tag color rules Tag colors help you recognize categories at a glance. ### Rules - Choose from the available color palette. - Use high-contrast colors for readability. ### Tips - Keep a consistent color scheme across similar tags. ## Troubleshooting Use these fixes when tag actions fail. ### Failed to create tag - Check tag name uniqueness. - Verify you have permission to create tags. ### Duplicate tag name - Use a different name. - Search existing tags first. ### Invalid tag color - Select a color from the provided palette. ### Failed to update tag - Ensure the new name is unique. - Retry after refreshing. ### Failed to remove tag - Confirm you have delete permission. - Try again after refreshing. --- ### Partners Canonical URL: https://hoko.to/help/partners # Partners ## Partner concept Partners represent affiliates or collaborators tied to links. ### Why it matters - Attribute traffic to partners. - Measure partner performance. ### How it connects - A link can reference one partner. - Partners are optional for links. ## Create a partner Create a partner to track affiliate or collaborator links. ### Where to find it - Dashboard → Partners ### Steps 1. Open Partners. 2. Select New partner. 3. Enter the partner name. 4. Save the partner. ### Notes - Partner name is required. - Email and phone are optional. ## Update a partner Update partner details to keep records accurate. ### Where to find it - Dashboard → Partners ### Steps 1. Open Partners. 2. Select a partner. 3. Edit details. 4. Save changes. ## Remove a partner Remove a partner when it is no longer needed. ### Where to find it - Dashboard → Partners ### Steps 1. Open Partners. 2. Select Remove on the partner. 3. Confirm deletion. ### Notes - Removing a partner does not delete links. - Links will lose the partner association. ## Troubleshooting Use these fixes when partner actions fail. ### Failed to create partner - Ensure the partner name is provided. - Retry after refreshing. ### Failed to update partner - Retry after refreshing. - Check required fields. ### Failed to remove partner - Confirm you have delete permission. - Try again after refreshing. --- ### UTM templates Canonical URL: https://hoko.to/help/utm-templates # UTM templates ## UTM template concept UTM templates store reusable tracking parameters for links. ### Why it matters - Keep campaign tracking consistent. - Reduce manual entry when creating links. ### How it connects - Templates can be applied in link dialogs. - Templates do not change existing links unless applied. ## Create a UTM template Create a template to reuse UTM parameters. ### Where to find it - Dashboard → Library → UTM Templates ### Steps 1. Open UTM Templates. 2. Select New template. 3. Enter template name and UTM fields. 4. Save the template. ### Notes - Template name is required and must be unique. - Provide at least one UTM field. - Only fill the UTM fields you need. ## Update a UTM template Update template values to keep tracking accurate. ### Where to find it - Dashboard → Library → UTM Templates ### Steps 1. Open UTM Templates. 2. Select a template. 3. Edit fields and save. ## Remove a UTM template Remove a template you no longer need. ### Where to find it - Dashboard → Library → UTM Templates ### Steps 1. Open UTM Templates. 2. Select Remove on the template. 3. Confirm deletion. ### Notes - Removing a template does not change existing links. ## Troubleshooting Use these fixes when template actions fail. ### Failed to create UTM template - Check that the name is unique. - Retry after refreshing. ### Duplicate template name - Choose a different template name. ### Failed to update UTM template - Retry after refreshing. - Check required fields. ### Failed to remove UTM template - Confirm you have delete permission. - Try again after refreshing. --- ### Analytics Canonical URL: https://hoko.to/help/analytics # Analytics ## Analytics overview Analytics show how your links perform over time. ### What you can see - Clicks - Leads - Sales - Top referrers - UTM breakdowns - Tag performance ### Data window By default analytics load the last 30 days and are limited by your plan event caps. > [!INFO] Analytics are scoped to collections you can access. ## Analytics scope by collection Analytics only include collections you have access to. ### Access rules - Viewer or higher access is required to see analytics. - Blocked or removed participants do not see analytics. - If you have no accessible collections, analytics are empty. ## Click analytics explained Click analytics record every visit to a link. ### Captured details - Destination - Referrer - UTM parameters - Device and browser - Location ### How to use - Spot top-performing campaigns. - Understand traffic sources. ## Lead analytics explained Lead analytics show conversions captured as leads. ### Lead events - Recorded when a lead is tracked. - Linked to a click and a link. ### How to use - Measure campaign quality. - Compare clicks to leads for conversion rate. ## Sale analytics explained Sale analytics track revenue events tied to links. ### Sale events - Recorded when a sale is tracked. - Includes amount and currency when provided. ### How to use - Measure ROI per campaign. - Compare revenue across collections. ## Filter behavior Analytics filters refine what data you see. ### Filter effects - Filters apply to charts and tables. - Multiple filters combine together. - Clear filters to reset the view. ## Export analytics data Export analytics to CSV for reporting. ### How export works - Exports reflect current filters. - Includes recent data from the analytics window. ### Tips - Apply filters before exporting. - Use a spreadsheet to build charts. ## Troubleshooting Use these fixes when analytics does not load or looks incomplete. ### Missing analytics data - Confirm you have activity in the last 30 days. - Check collection access. ### Access denied to analytics - Ask an owner to grant viewer access. - Switch to a collection you can access. ### Export failed - Try exporting with fewer filters. - Reload the page and retry. ### Slow analytics load - Apply filters to reduce data volume. - Refresh and try again later. --- ### Participants Canonical URL: https://hoko.to/help/participants # Participants ## Participant roles explained Participant roles control access per collection. ### Roles - Owner: full access and workspace management. - Admin: manage collections and invite members. - Editor: create and edit links and content. - Viewer: read-only access. - No access: hidden from the member. ### Scope Roles are assigned per collection and can differ across collections. ## Invite a participant Invite a participant and choose their collection roles. ### Where to find it - Dashboard → Settings → Participants ### Steps 1. Open Participants settings. 2. Enter the member email. 3. Assign roles for collections. 4. Send the invite. ### Notes - Invites are scoped to collections. - Members only see collections they are assigned to. ## Assign collection roles Assign different roles per collection for the same member. ### Where to find it - Dashboard → Settings → Participants ### Steps 1. Open Participants settings. 2. Select a member or invite form. 3. Choose a role for each collection. 4. Save the changes. ### Notes - Setting a role to none hides the collection for that member. ## Resend an invite Resend an invite if the email was missed. ### Where to find it - Dashboard → Settings → Participants ### Steps 1. Open Participants settings. 2. Find the pending invite. 3. Select Resend invite. ### Notes - Only pending invites can be resent. ## Revoke an invite Revoke an invite to stop it from being accepted. ### Where to find it - Dashboard → Settings → Participants ### Steps 1. Open Participants settings. 2. Find the pending invite. 3. Select Revoke invite. ### Notes - Revoked invites cannot be accepted. ## Update member roles Change a member role for one or more collections. ### Where to find it - Dashboard → Settings → Participants ### Steps 1. Open Participants settings. 2. Select the member. 3. Adjust roles per collection. 4. Save the changes. ### Notes - Keep at least one owner in the workspace. ## Remove a participant Remove a participant from the workspace. ### Where to find it - Dashboard → Settings → Participants ### Steps 1. Open Participants settings. 2. Select the member. 3. Choose Remove participant. 4. Confirm removal. > [!WARNING] You cannot remove the last remaining owner. ## Transfer ownership Transfer ownership by promoting another member to owner. ### Where to find it - Dashboard → Settings → Participants ### Steps 1. Open Participants settings. 2. Select the member. 3. Assign the owner role. 4. Confirm the change. ### Notes - Keep at least one owner at all times. ## Troubleshooting Use these fixes when participant actions fail. ### Invite not delivered - Check the email address. - Ask the invitee to check spam. - Resend the invite. ### Invite already exists - Check pending invites. - Revoke and resend if needed. ### Role assignment failed - Ensure you have admin or owner permissions. - Retry after refreshing. ### Ownership transfer blocked - Make sure at least one owner remains. - Confirm the target member has access. ### Failed to remove participant - Ensure you are not removing the last owner. - Retry after refreshing. --- ### API keys Canonical URL: https://hoko.to/help/api-keys # API keys ## API key concept API keys allow programmatic access to your workspace data. ### Why it matters - Integrate with external tools. - Control access through scopes. ### How it connects - Each key has read and write scopes. - Keys are tied to the workspace. - Allowed hostnames can limit browser usage. > [!INFO] Treat API keys like passwords. ## Create an API key Create a key for integrations and automation. ### Where to find it - Dashboard → Integrations → API Keys ### Steps 1. Open API Keys. 2. Select New key. 3. Choose scopes. 4. Add allowed hostnames if needed. 5. Create and copy the key. ### Notes - You may only see the key value once. - Store it securely. ## API key scopes explained Scopes control what an API key can access. ### Scope types - Read: view data - Write: create or update data ### Best practice - Grant only the scopes you need. - Use separate keys per integration. ## Allowed hostnames configuration Limit browser usage by restricting where a key can be used. ### How it works - Hoko checks the Origin or Referer hostname when present. - Requests without those headers are not filtered by hostname. - Leave the list empty to allow any hostname. ### Examples - `example.com` - `api.example.com` - `*.example.com` ## Update API key settings Adjust the name, scopes, and allowed hostnames. ### Where to find it - Dashboard → Integrations → API Keys ### Steps 1. Open API Keys. 2. Select the key. 3. Update the fields. 4. Save changes. ## Revoke an API key Revoke a key to stop its access immediately. ### Where to find it - Dashboard → Integrations → API Keys ### Steps 1. Open API Keys. 2. Select the key. 3. Choose Revoke. 4. Confirm the action. > [!WARNING] Revoking a key will break integrations using it. ## Troubleshooting Use these fixes when API key actions fail. ### Failed to create API key - Check required scopes. - Retry after refreshing. ### Missing required scopes - Select at least one scope. ### Invalid API key - Verify you copied the full key. - Generate a new key if needed. - Check allowed hostnames when calling from a browser. ### Hostname blocked - Ensure the request Origin or Referer matches an allowed hostname. - Add the hostname to the allowlist and try again. ### API key revoked - Create a new key and update your integration. --- ### Billing Canonical URL: https://hoko.to/help/billing # Billing ## Current plan View your current plan and usage limits. ### Where to check - Dashboard → Settings → Subscription ### What you will see - Plan name - Usage counters - Billing status ## Usage limits explained Usage limits define how many resources you can use per cycle. ### Typical limits - Links - Events - Collections - Tags - Users ### Cycle reset Usage resets every billing cycle. You can track the cycle dates in the usage panel. ## Upgrade a plan Upgrade to increase limits and access more features. ### Where to find it - Dashboard → Settings → Subscription ### Steps 1. Open the Subscription page. 2. Choose a higher plan. 3. Complete checkout. ## Downgrade a plan Downgrade if you no longer need higher limits. ### Where to find it - Dashboard → Settings → Subscription ### Steps 1. Open the Subscription page. 2. Choose a lower plan. 3. Confirm the change. > [!WARNING] If your usage exceeds the new limits, some actions may be blocked. ## Troubleshooting Use these fixes when billing updates fail. ### Checkout failed - Verify payment details. - Try again with a different card. ### Plan not updated - Refresh the page. - Wait a few minutes and retry. ### Limits not refreshed - Sign out and sign in again. - Contact support if it persists. --- ### Storage Canonical URL: https://hoko.to/help/storage # Storage ## Image upload flow Images are uploaded in a secure flow that uses signed URLs. ### Upload steps 1. The client hashes the image with SHA256. 2. The server issues a signed upload URL. 3. The image is uploaded to the avatar bucket. 4. The server stores the hash file name in the database. ## Image hashing rules Hashing ensures consistent storage and naming. ### Hash requirements - SHA256 hash of the file contents. - File name is hash.png. - Bucket is avatar. ### Folder rules - Profile images use folder {profileId}. - Workspace images use folder {workspaceId}. ## Avatar URL behavior Image URLs are built on the server and sent to the client. ### How URLs are built - The database stores only hash.png. - The server builds /storage/avatar/{folderId}/hash.png. ### Fallbacks - If an image fails to load, initials are shown. - If no image is set, initials are used by default. ## Troubleshooting Use these fixes when image uploads fail. ### Failed to generate upload URL - Retry the upload. - Check that the file hash is valid. ### Storage resource not found - Confirm the bucket name is avatar. - Ensure the folder ID matches the profile or workspace ID. ### Upload rejected - Use PNG, JPG, or SVG. - Keep the file under 2 MB. ### Image not visible - Refresh the page. - Check that the image URL is reachable. --- ### Security Canonical URL: https://hoko.to/help/security # Security ## Session lifecycle Sessions keep you signed in across visits. ### Session behavior - Sessions are stored in cookies. - Tokens refresh automatically when possible. - Signing out clears the session. ## Cookie workspace selection Your active workspace and collection are stored in cookies. ### What is stored - currentWorkspaceId - currentCollectionId ### How it is used - Restores your last selection on next visit. - Falls back to default collection if needed. ## Access removal behavior When access is removed, your permissions update immediately. ### What happens - Collections you no longer access disappear. - The system selects another accessible collection. - If no access remains, you are redirected to sign in. ## Troubleshooting Use these fixes when security-related access issues occur. ### Session invalid - Sign in again. - Clear cookies if the issue persists. ### Access revoked - Contact a workspace owner to restore access. - Check your invite status. ### Workspace not accessible - Switch to another workspace. - Sign out and back in. ---