--- url: https://docs.codefox.ai/apps/library.md --- # Library, documents and pages Library is where your company writes and keeps what it knows: pages people edit together, the files they upload, and the documents other Foxden apps file there. Every change is kept as a version, every page can be found again by search, and a page can be sent outside the company as a single read-only share or in a room. Library is also the one place where the other Foxden apps keep their file bytes. That side has no screens of its own; it is described in [The file store](/how-it-works/file-store). ## Who uses Library * **People who can use Library** write and read pages in the spaces they belong to, make spaces of their own, share pages and make rooms. * **People who can manage Library** also set it up for the company: space types, templates, room types, the brand PDFs wear, search and Ask. See [Set up Library for your team](/apps/library/set-up-for-your-team). * **People outside the company** read what you send them without an account: a page shared with them ([Open a page someone shared with you](/apps/library/open-a-shared-page)) or a room made for them ([Open a room someone made for you](/apps/library/visit-a-room)). * **AI assistants** reach Library through the gateway in Foxden Admin and act as the person they work for, never with more access than that person. See [Connect your AI assistant](/connect/ai-assistant). ## Spaces A space is a shared home for one team, project or topic. Everyone it is shared with sees the same pages. Each space says who can open it: | Choice | Who can open it | |---|---| | **Everyone** | Everyone in the organisation. | | **Managers** | People who can manage Library, and the space's own members. | | **Private** | Only the space's own members. Not people who can manage Library, and not the Owner. | Inside a space each member **Can read**, **Can edit** or **Can manage** it. Someone who can manage a space decides who is in it and how it works, from its **More** menu, **People and settings**. Every space has at least one person managing it. Every person also has a personal space, shown in the sidebar under **Your space**, that only they can open. Spaces come in kinds your company defines, called space types. A new install starts with **Team spaces** (new ones are private) and **Clients** (new ones open to everyone, one for each client company, linked to Fennec when Fennec is connected). It also starts with three spaces: **Wiki**, **Company** and **Templates**. ## Pages A page is anything worth keeping. There are three kinds: * **A page** of text you write in the editor, with headings, lists, tables, images and links to other pages. * **A file**: anything you upload, such as a PDF, a spreadsheet or a video, with a preview where Library can show one. * **An interactive page**: HTML you write or upload (one file, or a small site as a zip), such as a calculator or a chart. It runs in a frame of its own, kept apart from the rest of Library. Pages sit in a tree inside their space, so a page can hold pages under it, and a folder is a page that holds others. ## Versions What you type is saved as you go, and Library cuts a version when everyone leaves the page or after 10 minutes with no typing. You can also save and name a version yourself, for one you will send. The page's **History** shows every version, compares any two and restores an older one. Nothing in a page's history is lost when someone restores. ## Comments and suggestions Anyone who can read a page can comment on a passage of it and mention a colleague, unless the space's managers have narrowed that to its editors. Instead of editing, a person can **Suggest** a change, which waits in **Inbox** for the people the space asks to review it, until one of them accepts or turns it down. ## Sharing There are three ways for a page to reach someone who is not in its space: * **A colleague** reads one version of the page under **Shared with me**, and nothing else in the space. * **Someone outside** is sent one version by email, and proves it is them with a code each time they open it. * **A link** opens one version, or always the latest, with an optional password, code and expiry. A **room** is for sending several documents to people outside the company together, on one page that carries your brand, with entry steps if you want them, and a record of who read what. See [Share pages and documents](/apps/library/share-pages-and-rooms). ## Files from other apps Corsac and Fennec can file their documents in Library, each as a file page with versions and a note that links back to the record it came from. A document that is open to everyone in its app and belongs to a client lands in that client's space. Any other lands in a space named after the app, which people who can manage Library can open, in a folder called **Signed documents** (Corsac) or **Documents** (Fennec). Whether an app files there is a setting in that app, for someone who can manage it. Files that other apps keep for themselves, such as form uploads, are held in the file store but do not appear as pages. ## Ask, AI and the brain Library can answer a question from the pages you can open, with each point linked to the passage it came from. It can draft a page from a short brief, search by meaning as well as by words, and do work on its own (filing call notes, drafting follow-ups, suggesting fixes to stale or duplicate pages), which Library calls the brain. Every AI change is marked in a page's history, and everything one AI session wrote can be undone together from **Settings**, **AI sessions**. ## What needs setting up first * **AI** (Ask, drafting, search by meaning, the brain) needs Library connected to Foxden Admin, with AI set up in Admin. Without it, Library hides the Ask box. See [AI in Foxden Admin](/run-your-company/ai). * **Agent access** (an AI assistant reading or writing pages) needs Foxden Admin: assistants connect only through its gateway. See [Connect your AI assistant](/connect/ai-assistant). * **Email** is needed to send a page to someone outside, to ask for a code on a link, to email room invitations and answers, and to send notifications by email. Without it, a room's people get links for you to copy and send. See [Email](/self-host/email). * **PDF export** needs the server's PDF renderer. Without it, **Export to PDF** is not shown. * **Imports** from Notion, Confluence, git and archives run from the server's command line. See [Running Library](/self-host/running-library). ## Pages in this section * [Write your first page in Library](/apps/library/get-started): start here. * [Write and organise pages](/apps/library/write-and-organise-pages): write together, link, comment, suggest, keep versions, move and trash pages. * [Upload files and find what you need](/apps/library/upload-and-find-files): files and their versions, documents from other apps, search and Ask. * [Share pages and documents](/apps/library/share-pages-and-rooms): share a page with a colleague or someone outside, and make a room. * [Set up Library for your team](/apps/library/set-up-for-your-team): for people who can manage Library. * [Library settings](/reference/settings/library) and [Library agent tools](/reference/agent-tools/library): to look things up.