NewYour AI employee is one email away →

Documentation

Learn how to set up and get the most out of Viktor.

Viktor Docs

Have Viktor publish reports, plans and charts as docs with a stable link, and manage who can open them.

Viktor can publish a report, plan, chart or write-up as a doc with a stable link. A doc is a single HTML file: it can be interactive in the browser, but it has no database or server logic, and it shows the data from when it was published. For an app that stores data or pulls live data, ask for a Space instead.

Publish a doc

  1. Ask Viktor in Slack, Teams or the web app: "Publish this quarter's pipeline review as a doc."
  2. Viktor publishes the doc and replies with its link and a note on who can open it.
  3. When he shares the doc in a conversation, a preview image of it usually follows in the thread shortly after.

To update a doc, ask Viktor to republish it. Republishing under the same name updates the doc at the same link, so a scheduled task can keep a recurring report current. The previous content is kept as a version.

Start from the web app

  1. Open Docs and select New doc.
  2. Pick a starting point, such as Weekly report or Data deep-dive.
  3. You land in chat with the prompt filled in. Send it, and Viktor publishes the result as a doc.

New doc only appears when web chat is available in your workspace.

Choose who can open a doc

Each doc has one of three access settings:

  • Workspace members (the default): "Only signed-in members of your workspace can open this doc."
  • Specific people: "Only the doc's access manager and the people picked below can open this doc."
  • Public: "Anyone with the link can view and share this doc." Viktor only makes a doc public when you confirm it may be open to the internet.

To change it, open the doc from Docs and pick an option under Who can open this doc, or ask Viktor. Changes apply without republishing.

Members-only links don't show a preview when pasted in chat. That's why Viktor posts a preview image separately.

Manage docs

Docs lists every doc in the workspace.

  • Switch between All docs, Created by me, Pinned and Unfiled, and filter by Creator and Access.
  • Select several docs to Move to collection, set them to Workspace only, Make public or Delete in one go. Making docs public asks you to confirm: "Anyone with the link will be able to open them."
  • Each doc's menu has Pin, Open in new tab, Copy link, Share, Duplicate, Edit and Delete.

Rename a doc's URL

  1. Open the doc and edit the URL slug (lowercase letters, digits and hyphens, up to 60 characters).
  2. Select Save and confirm Rename this doc's URL?.

The old link redirects for signed-in workspace members. Anonymous visitors to a public doc must use the new link.

Restore an earlier version

  1. Open the doc and select Show next to Version history.
  2. Select Preview to look at a version, then Restore.
  3. Confirm Restore this version?. The current content is kept as a snapshot, so you can restore it back.

The 10 most recent previous versions are kept.

Transfer the manager role

Every doc has an Access manager, normally the person it was published for. To hand it over, open the doc, use Transfer to… under Access manager, and confirm Transfer the manager role?.

Delete a doc

Select Delete in the doc's menu and confirm Delete doc?. The doc "will be deleted and its URL stops working immediately. This cannot be undone."

Workspace Docs settings

Workspace admins manage these under Docs settings (the gear next to New doc in Docs):

  • Docs address: the address your docs are published at. When a readable address based on your workspace name is available, an admin can select Move docs to {hostname} and confirm with Move docs. Links to the old address keep working; they redirect.
  • "Made with Viktor" badge: show or hide the small badge on docs. Turning it off applies to future publishes. Already-published docs keep it until they are republished.
  • Custom domains: serve all of the workspace's docs on your own domain, such as docs.yourcompany.com/weekly-report. You add a TXT record and a CNAME record at your DNS provider, then select Check. One domain covers every doc; a single doc can't have its own domain. Opening the domain's root takes people to the Docs overview.

Limits

  • A doc is one self-contained HTML file of up to 2 MB. Images and scripts must be inline or loaded from full https:// URLs; relative file paths don't load.
  • Only the doc's access manager and workspace admins can change its access, rename it, transfer the manager role, restore versions or delete it. Others see "Only {name} and workspace admins can change access. Everyone on the team can view these settings."
  • Anyone who can open a doc can duplicate it.
  • Docs settings are for workspace admins only. Other members see "Admins only".
  • The Orphaned creator filter, for docs with no access manager, is shown to workspace admins only.
  • Custom domains count toward the workspace's limit of 20, shared with Space custom domains.

Common problems

  • The doc looks broken or images are missing. The doc probably points to files by relative path. Ask Viktor to inline the images or use full URLs, and republish.
  • The doc is too large. Docs are capped at 2 MB. Ask Viktor to compress images or split the doc.
  • A teammate can't open the doc. Check Who can open this doc. With Specific people, add them. Someone signed in to a different workspace lands on an access-denied page; see Space access and domains.
  • The data in the doc is out of date. Docs don't update themselves. Ask Viktor to republish, or to republish on a schedule.
  • You can't see the Docs settings controls. They are for workspace admins.
Get Started for Free