Frequently Asked Questions

Find quick answers to common questions about Kioju

What is Kioju?

Kioju is a powerful link sharing platform that allows you to save, organize, and share interesting web content. Think of it as your personal bookmark manager with superpowers!

Smart Collections

Automatically fetches page titles and descriptions

Privacy Controls

Choose between public and private links

Browser Extension

One-click sharing from any webpage

Secure

Two-factor authentication and API access

How do I create an account?

Account creation may depend on your account settings:

  • Invitation-based: You'll need an invitation code from an existing user
  • Open registration: Simply visit the registration page and sign up

After registration, check your email for a verification link to activate your account.

Why do I need to verify my email for both the waiting list and registration?

Kioju requires email verification (double opt-in) for both the waiting list and account registration for several important reasons:

The Process:
  • Waiting List: Verify your email to confirm your application
  • Registration: Verify your email to activate your account
  • Result: This creates a secure, legally compliant, and spam-free environment for all users
Important: Always check your spam/junk folder if you don't receive the verification email within a few minutes. The email comes from no-reply@kioju.de.
How can I download my data?

Kioju provides full GDPR-compliant data portability. You can download all your personal data at any time:

How to Export: Go to Profile → Data Management → Export Data
GDPR Compliance: This feature fulfills your right to data portability under GDPR Article 20. Your data is yours, and we make it easy to get it.
How can I delete my account?

You can permanently delete your Kioju account and all associated data at any time. This action is irreversible and complies with GDPR "Right to be Forgotten" requirements:

Important: Account deletion is permanent and cannot be undone. Consider downloading your data first if you want to keep a copy.
How to Delete: Go to Profile → Data Management → Delete Account
GDPR Compliance: This feature fulfills your right to erasure under GDPR Article 17 ("Right to be Forgotten"). Once deleted, your data is permanently removed from our systems.
How do I add my first link?

There are several ways to add links to your collection:

  1. Manual Entry: Go to "Manage Links" and click the "Add New Link" button. Paste any URL and the title and description will be fetched automatically.
  2. Browser Extensions: Install our Chrome or Firefox extensions for one-click sharing (respects your account's rate limits)
  3. API: Use our REST API for programmatic access with tiered rate limits
Pro Tip: The browser extensions are the fastest way to share interesting content while browsing! Free users get 25 submissions per hour, premium users get 100.
Why does Kioju use an invitation system?

Kioju uses an invitation-only system to maintain a high-quality community and ensure sustainable growth. This approach helps us:

  • Quality Control: Ensure users are genuinely interested in thoughtful link curation
  • Community Building: Foster a engaged community of users who value quality content
  • Resource Management: Scale our platform responsibly as we grow
  • Reduce Spam: Minimize automated signups and low-quality content

Think of it like a curated community where every member contributes to the overall quality of shared content.

How does the invitation system work?

Our invitation system is designed to be simple and accessible:

1
Join the Waiting List

Visit our waiting list page and provide your email, name, and tell us why you're interested in Kioju.

2
Wait for Your Invitation

Our administrators regularly review the waiting list and send out invitations. We prioritize users who clearly explain their interest in quality link curation.

3
Receive Your Invitation Token

When selected, you'll receive an invitation token that allows you to create your account.

4
Create Your Account

Use your invitation token on the registration page to create your Kioju account.

How can I get an invitation?

There are several ways to get invited to Kioju:

Join the Official Waiting List

The most reliable way is to join our waiting list. Be specific about why you want to use Kioju and what types of content you plan to curate.

Get Invited by Existing Users

Current Kioju users receive invitation tokens that they can share with friends and colleagues who would benefit from the platform.

Contact Us Directly

If you have a specific use case or represent an organization that would benefit from Kioju, you can reach out to us directly.

How long does it take to get invited?

Invitation timing depends on several factors:

  • Current demand: Popular periods may have longer wait times
  • Application quality: Well-written applications explaining your use case are prioritized
  • Platform capacity: We invite users in batches to ensure good server performance

Typically, most users receive invitations within 1-4 weeks of joining the waiting list. We send email updates about your status.

I have an invitation token, now what?

Great! Here's how to use your invitation token:

1
Go to the Registration Page

Visit the account creation page on Kioju

2
Enter Your Invitation Token

Paste your invitation token in the designated field

3
Fill Out Your Details

Complete the registration form with your username, email, and password

4
Verify Your Email

Check your email and click the verification link to activate your account

Note: Invitation tokens are single-use and expire after 30 days. Use yours as soon as possible!
What are Collections?

Collections are themed groups of links that help you organize and present your content in a meaningful way. Think of them as curated playlists for web content.

Organized Curation

Group related links by topic, project, or theme

Visibility Control

Set collections as public, private, or selective sharing

Custom Presentation

Add descriptions and context to your collections

Examples of collections:

  • "Web Development Resources" - Tools, tutorials, and documentation
  • "Weekend Reading" - Interesting articles and stories
  • "Design Inspiration" - Beautiful websites and creative work
  • "Research Papers" - Academic sources for a specific project
How do I create a collection?

Creating a collection is simple:

1
Go to Collections Page

Navigate to the "Collections" section in your dashboard

2
Click "Create Collection"

Choose a descriptive name and add an optional description

3
Set Visibility

Choose who can see this collection (private, selective, or public)

4
Start Adding Links

Add links directly or move existing links into your new collection

How do I add links to a collection?

You can add links to collections in several ways:

During Link Creation

When adding a new link, select which collection it should belong to from the dropdown menu.

Move Existing Links

From your links management page, select links and use "Move to Collection" to organize them.

Edit Link Details

Edit any existing link and change its collection assignment.

Tip: A single link can belong to multiple collections! This is useful for cross-categorization.
How do collection URLs work?

Each collection gets its own clean, shareable URL:

Format: https://kioju.de/c/your-collection-name
Example: https://kioju.de/c/web-dev-resources
1
Automatic URL Generation

Collection names are automatically converted to clean URLs (spaces become hyphens, special characters removed)

2
SEO-Friendly

Collection URLs are optimized for search engines and social media sharing

3
Easy Sharing

Share the collection URL directly, no need for complex link structures

What are the different collection visibility levels?

Kioju offers flexible privacy controls for your collections:

Private Collections

Only you can see these. Perfect for personal bookmarks, work-in-progress research, or sensitive content. Private collections don't appear in public listings or search results.

Selective Collections

Share with specific people. Generate unique sharing URLs that you can send to colleagues, friends, or collaborators. Not publicly listed but accessible to anyone with the link.

Public Collections

Visible to everyone. Appear in Kioju's public collection directory, search results, and your public profile. Great for building your reputation and sharing expertise with the community.

Privacy Control: You can change a collection's visibility level at any time. Moving from public to private immediately removes it from all public listings.
What's new in the interface?

Kioju's interface has been continuously improved for better user experience:

Modal Windows

Clean popup modals for adding and editing links without page refreshes

Live URL Previews

See page titles and descriptions automatically as you add links

Mobile Optimized

Fully responsive design that works beautifully on all devices

These improvements make link management faster and more intuitive than ever before.

How does the URL preview work?

When you add a new link, Kioju automatically fetches information about the webpage:

1
Paste URL

Simply paste any valid URL into the link field

2
Automatic Fetch

Kioju retrieves the page title, description, and other metadata

3
Review & Edit

You can edit the title and description before saving if needed

Fast & Accurate: URL preview works with most websites and respects rate limits to ensure reliable fetching.
Are the modals mobile-friendly?

Yes! Kioju's modal windows are fully optimized for mobile devices:

  • Touch-friendly: Large buttons and touch targets
  • Responsive layout: Adapts to different screen sizes
  • Easy navigation: Swipe gestures and intuitive controls
  • Keyboard support: Works with external keyboards on tablets

Whether you're using a phone, tablet, or desktop, the experience is consistent and user-friendly.

Which browsers are supported?

Kioju browser extensions are available for:

Google Chrome

Full support for Chrome and Chromium-based browsers

Mozilla Firefox

Native Firefox extension with all features

Microsoft Edge

Compatible with Chrome extension (Chromium-based)

How do I install the browser extensions?

Installing Kioju browser extensions is simple. Choose the method that works best for you:

🏪 Firefox: Install from Mozilla Add-ons (Recommended)
1
Visit the Store

Go to Mozilla Add-ons or click "Install from Firefox Add-ons" on our downloads page

2
Install Extension

Click "Add to Firefox" and confirm the installation when prompted

3
Configure Settings

Click the Kioju icon → Options → Enter your API key from your Kioju profile

🔧 Manual Installation (All Browsers)
1
Download Extension

Visit the downloads page and get the extension file for your browser

2
Enable Developer Mode

In Chrome: chrome://extensions/ → Enable "Developer mode"
In Firefox: about:debugging → "This Firefox" → "Load Temporary Add-on"

3
Load Extension

Chrome: Click "Load unpacked" and select the extracted folder
Firefox: Select the manifest.json file

4
Configure Settings

Right-click the extension icon → Options → Enter your Kioju server URL and credentials

Note: Extensions respect your account's rate limits. Make sure your server URL is correct and accessible.
The extension isn't working on certain websites

Some websites may block browser extensions due to their security policies:

Content Security Policy (CSP)

Some sites block external scripts. Banking sites, government portals, and secure corporate sites often have strict CSP.

Incognito/Private Mode

Extensions are disabled by default in private browsing. Enable them manually in browser settings if needed.

Local File Pages

Extensions don't work on file:// URLs, browser settings pages, or extension pages for security reasons.

Workaround: You can always copy the URL and add it manually through the Kioju web interface.
Can I edit link titles and descriptions?

Yes! You have full control over how your links appear:

Custom Titles

Edit titles to make them more descriptive or personal

Custom Descriptions

Add your own context and notes to any link

Organization

Use consistent naming for better organization

Simply click the edit button next to any link to modify its title, description, or collection assignment.

How do I delete a link?

Deleting links is straightforward:

1
Go to Manage Links

Navigate to your link management page

2
Find the Link

Use search or browse to locate the link you want to delete

3
Click Delete

Click the red delete button next to the link

4
Confirm Deletion

Confirm the action when prompted

Warning: Deleted links cannot be recovered. Make sure you really want to remove the link permanently.
What's the difference between public and private links?

Kioju offers flexible privacy controls for individual links:

Private Links

Only visible to you. Great for personal bookmarks, work-in-progress research, or sensitive content you don't want to share.

Public Links

Visible in your public profile and can appear in public collections. Perfect for building your online presence and sharing expertise.

You can change a link's privacy setting at any time by editing it.

How do I share my public profile?

Your public profile showcases your best curated content:

Your Profile URL: https://kioju.de/u/your-username

Direct Sharing

Share your profile URL on social media, email signatures, or business cards

SEO Benefits

Public profiles are indexed by search engines and help establish your expertise

Professional Networking

Use your profile to showcase curated resources in your field of expertise

How do I report inappropriate content?

Help keep our community safe by reporting inappropriate or harmful content:

Logged-in Users Only

You must be logged in to report content. This helps prevent abuse of the reporting system.

Report Links

When viewing someone's links, look for the "Report" button next to the date on each link.

What to Report

Report links that contain spam, malicious content, copyright violations, or violate community guidelines.

Note: You cannot report your own links, and the report button only appears when viewing other users' public content while logged in.
How can I share my collections on social media?

Kioju provides built-in social media sharing buttons for all your public and hidden collections:

LinkedIn

Share professional collections to your LinkedIn network. Perfect for career-related resources and industry insights.

Twitter/X

Tweet your collections with a pre-formatted message including the collection title and link.

Instagram

Copy the link to share in your Instagram bio, stories, or post comments. Get helpful instructions automatically.

1
Find the Buttons

Social sharing buttons appear under each public or hidden collection on your Collections page

2
Click to Share

LinkedIn and Twitter will open sharing dialogs. Instagram copies the link and shows instructions

3
Or Copy Link

Use the copy button to get the direct link for any social platform or messaging app

Private Collections: Social sharing buttons only appear for public and hidden collections. Private collections are not meant to be shared.
Pro Tip: Collections with good descriptions and titles perform better on social media as they provide context for your shared links.
How secure is my data?

Kioju takes security seriously and implements multiple layers of protection:

Encryption

All data transmission is encrypted using HTTPS/TLS. Passwords are hashed using secure algorithms before storage.

Privacy by Design

We don't track your browsing habits, sell your data, or use invasive analytics. Your content belongs to you.

Data Storage

All data is stored securely with regular backups. We follow best practices for database security and access control.

Who can see my links?

You have complete control over who can access your content:

Private Links

Only you can see private links. They never appear in public listings or search results.

Selective Sharing

Share specific collections with unique URLs. Only people with the link can access them.

Public Content

Public links appear in your profile and can be discovered by others. You choose what to make public.

Can I report inappropriate content?

Yes! Kioju has mechanisms to report problematic content:

1
Find Report Option

Look for "Report" links next to public content that violates community guidelines

2
Provide Details

Describe why the content is inappropriate (spam, harmful, copyright violation, etc.)

3
Administrator Review

Reports are reviewed by administrators who will take appropriate action

Community Standards: Help keep Kioju a quality platform by reporting content that doesn't belong.
What is Two-Factor Authentication (2FA)?

Two-Factor Authentication adds an extra layer of security to your account:

Something You Know

Your password (first factor)

Something You Have

Your phone with an authenticator app (second factor)

Even if someone gets your password, they can't access your account without the second factor from your phone.

How do I enable 2FA?

Setting up 2FA is quick and secure:

1
Install Authenticator App

Download Google Authenticator, Authy, or any TOTP-compatible app

2
Go to Profile Settings

Navigate to your user profile and find the 2FA section

3
Scan QR Code

Use your authenticator app to scan the displayed QR code

4
Enter Verification Code

Type the 6-digit code from your app to complete setup

5
Save Backup Codes

Store your recovery codes in a secure location

I lost my phone. How do I access my account?

If you lose access to your 2FA device, you have recovery options:

Backup Codes

Use one of the recovery codes you saved when setting up 2FA. Each code can only be used once.

Contact Administrator

If you don't have backup codes, contact your instance administrator with account verification details.

Account Recovery

Administrators can disable 2FA for your account after verifying your identity.

Important: Always save your backup codes when enabling 2FA. Store them securely offline.
What can I do with the API?

The Kioju API provides programmatic access to most platform features:

Add Links

Programmatically add links from scripts, services, or other applications

Manage Collections

Create, update, and organize collections via API calls

Export Data

Retrieve your links and collections for backup or migration

Example API Call:
POST /api/links
Content-Type: application/json
{"url": "https://example.com", "title": "Example Site"}
Where do I find my API key?

Your API key is available in your user profile:

1
Go to Profile

Navigate to your user profile page

2
Find API Section

Look for the "API Access" or "Developer" section

3
Copy API Key

Copy your unique API key and keep it secure

Keep It Secret: Your API key is like a password. Don't share it publicly or commit it to version control.
What are API rate limits?

API rate limits prevent abuse and ensure fair usage for all users:

Free Users

25 requests per hour - Perfect for personal automation and small scripts

Premium Users

100 requests per hour - Ideal for more intensive automation and integrations

Rate limits reset every hour. If you exceed your limit, you'll receive a 429 "Too Many Requests" response.

Can I backup all my links?

Yes! You can export your data for backup or migration:

API Export

Use API calls to retrieve all your links and collections programmatically

Web Interface

Use the Data Export feature in your profile settings to download your data

Data Formats

Export to JSON, CSV, or other standard formats

Data Ownership: Your data belongs to you. Export it anytime for backup or migration to other services.
Are links added via API public or private?

All links added through the API are automatically set to private for security and privacy reasons:

Security First: API-submitted links default to private to prevent accidental public exposure of potentially sensitive content.
Pro Tip: This approach lets you import links safely via API, then selectively choose which ones to make public after reviewing them.
What's the difference between private and public links?

Kioju offers different visibility levels for your links, giving you full control over what you share:

Easy to Switch: You can change link visibility anytime - from private to public or vice versa - using the edit link feature.

Default Settings

Web interface: Your choice
API submissions: Always private
Browser extension: Your choice

Collection Visibility

Collections also have visibility settings that work independently from individual link visibility

Your Control

You decide what to share and when - change visibility anytime without restrictions

Remember: Making a link public means it can be found by search engines and other users. Only make links public when you're comfortable with that level of visibility.
Why isn't the page title being fetched correctly?

Page title fetching can fail for several reasons. Here's how to troubleshoot:

HTTPS/SSL Issues

Some sites have invalid SSL certificates or mixed content. Try the HTTP version if available.

Bot Detection

Some sites block automated requests. The title fetch may be blocked by anti-bot measures.

JavaScript-Heavy Sites

Sites that generate titles with JavaScript may not work with basic title fetching.

1
Manual Override

Simply type your own title in the title field when adding the link

2
Try Later

Some sites have temporary issues. The fetch might work on retry

3
Check URL

Ensure the URL is correct and accessible in your browser

The Chrome extension shows an error. What should I do?

Extension errors usually have simple solutions:

Refresh Extension

Go to chrome://extensions/, find Kioju, and click the refresh button

Check Settings

Right-click the extension icon and verify your instance URL in options

Network Issues

Ensure you can access your Kioju instance directly in the browser

1
Check Console

Press F12 → Console tab to see detailed error messages

2
Verify Permissions

Make sure the extension has permissions for the current site

3
Re-install if Needed

Remove and reinstall the extension as a last resort

The extension doesn't work on certain websites. Why?

Some websites have restrictions that prevent extensions from working:

Content Security Policy (CSP)

Some sites block external scripts and connections, preventing extension functionality

Private/Incognito Mode

Extensions are often disabled in incognito mode by default

Restricted Sites

Browser internal pages (chrome://, about:) don't allow extension access

Workaround: Copy the URL and paste it directly into your Kioju instance instead of using the extension.
I can't connect to my Kioju instance. What's wrong?

Connection issues can have several causes:

Server Down

The Kioju instance server might be offline or undergoing maintenance

Wrong URL

Double-check the URL in your browser or extension settings

Firewall/Network

Your network, VPN, or firewall might be blocking the connection

1
Test in Browser

Try accessing your Kioju instance URL directly in a web browser

2
Check with Administrator

Contact your instance administrator about potential outages

3
Try Different Network

Test from a different internet connection to isolate network issues

Why aren't link previews loading?

Link previews might not load due to various technical reasons:

Loading Time

Previews are generated in the background and may take a few moments to appear

Source Issues

Some sites don't provide proper meta tags or block preview generation

Server Resources

High server load might delay preview generation for new links

Note: Not all websites support link previews. This is a limitation of the source site, not Kioju.
I'm getting permission errors. How do I fix this?

Permission errors usually relate to account access or server configuration:

Account Issues

Your account might be suspended, banned, or lack necessary privileges

Session Expired

You might need to log out and log back in to refresh your session

Server Configuration

File permissions or server settings might need administrator attention

1
Refresh Session

Log out completely and log back in

2
Check Account Status

Verify your account is in good standing with the administrator

3
Contact Support

If problems persist, contact your instance administrator

Others cannot see my links. What should I do?

If others can't see your links, it's likely a visibility setting issue. Here's how to troubleshoot:

Check Link Privacy

Links might be set to private. Only you can see private links.

Collection Visibility

Even public links won't be visible if they're in a private collection.

Account Status

Banned or suspended accounts can't share links publicly.

1
Check Link Visibility

Go to "Manage Links" → Edit the link → Change from "Private" to "Public"

2
Review Collection Settings

Ensure the collection containing your links is also set to public

3
Share the Right URL

Use your public profile URL or the specific collection/link sharing URL

4
Wait for Updates

Changes may take a few minutes to appear in search results and public listings

Quick Check

Open an incognito/private browser window and try to access the link. If you can't see it, others can't either.

API Users: Links added via API are automatically private. You must manually change them to public if you want others to see them.
Pro Tip: Copy your public profile URL or individual collection URLs to share them directly with others via social media, email, or messaging apps.
Is Kioju open source?

Kioju is not open source.

Check with Admin: Ask your instance administrator about the specific licensing and source availability.
What technology does Kioju use?

Kioju is built with modern, reliable web technologies:

Backend

PHP with MySQL/MariaDB database for reliable data storage and user management

Frontend

Modern responsive design with CSS Grid, JavaScript, and mobile-first principles

Security

HTTPS/TLS encryption, password hashing, 2FA support, and secure session management