--- url: https://docs.codefox.ai/apps/library/share-pages-and-rooms.md --- # Share pages and documents This page shows you how to share one page with a colleague or someone outside your company, and how to put several documents in a room for people outside to read, with a record of who read what. A share is a quick, read-only copy of one page. A room is one branded page for people outside, holding as many documents as you like, with entry steps, questions and a record of each visit. Both show a version you choose, never the page as it is being edited. ## Before you start * You need **Can edit** in the page's space to share it or put it in a room. * To share a page outside the company, the space's managers have to turn on **Let its editors share pages outside the organisation**, under **People and settings**, **Who can open it**, **Sharing outside**. It is off in a new space. * Sending a page by email, asking for a code on a link, and emailing room invitations and answers all need email on the server. See [Email](/self-host/email). ## Share a page with a colleague 1. Open the page and select **Share**. 2. Under **Share with**, choose **A colleague**. 3. Type their address in **Their email address**. They must already be in your company. 4. Under **Version**, choose the version to share. 5. Select **Share**. They read it under **Shared with me** in their sidebar, and nothing else in the space. ## Send a page to someone outside 1. Open the page and select **Share**. 2. Under **Share with**, choose **Someone outside**. 3. Type their address in **Their email address**. 4. Under **Version**, choose the version to send. 5. Type how many days it lasts in **Expires after (days)**. Leave it blank for no expiry. 6. Select **Send**. Library names the address and says it is outside your organisation. 7. Select **Send to** followed by the address. They get an email with an **Open it** button, and a code to that address each time they open it. ## Make a link 1. Open the page and select **Share**. 2. Under **Share with**, choose **A link**. 3. Under **Version**, choose a version, or **Always the latest version** for a link that follows the page. 4. Set **Expires after (days)** if it should stop on its own. 5. If you want, fill in: * **Name it (optional)**, to remember who the link is for. * **Password (optional)**, at least 12 characters. Send it some other way than the link. * **Ask for their email address**, so each reader proves their address with a code and you see who opened it. 6. Select **Make link**. The link is copied for you. Copy it now if it was not: Library keeps only a fingerprint of it and cannot show it again. ## See who opened a share, and stop it The **Share** dialog lists everything under **Shared now**, each with how many times it was opened and when. To end one, select **Stop sharing** beside it and confirm. It stops opening at once; who opened it stays on record. ## Put documents in a room 1. Select **Rooms** in the sidebar, then **New room**. You can also start from a space with **Share this space**, or from a page's **Add to a room**. 2. Type a **Name**, such as "Welcome pack". 3. Choose a **Room type**. This is asked only when your company has several. 4. Tick the documents to share. Started from a space, you can instead keep **All of** the space ticked to share the whole space and keep it up to date. 5. Select **Next**. 6. Under **Who can open it?**, choose one: * **Only people I name**: type their addresses in **Their email addresses**, one on each line. Each person gets a link of their own. * **Anyone with the link**: one link to send or post. Whoever opens it gives their name and email address. * **Anyone at one company**: type **The company's email domain**. Each person confirms their work email with a code. This needs email. 7. Select **Publish**, or **Publish and send** with the number of invitations. Without email, nobody is emailed: copy each person's link and send it yourself. 8. Select **Open the room** to finish it. On the room's own page you can write a welcome, and put items in order and in sections. To turn **Downloads** and **Printing** on or off for one item, open its menu and select **Downloads, stamp and more…**. **Preview** shows what a visitor sees, in a new tab, and records nothing. ## Ask visitors to take a step first An item can open **Straight away**, or only after a step. 1. On the room's page, open the item's menu. 2. Select **When it opens**. 3. Choose a step, such as **After they accept an NDA (adds a step in Share)**. The kinds of step are: * **Accept terms**: the visitor types their full name to accept. * **Verify an email address**: a code to their address. * **Answer questions** you write. * **Owner approval**: they ask to be let in, and you decide. * **Sign a document in Corsac**: needs Library connected to Corsac. * **The deal's own document, from Fennec**: for a room opened from a Fennec deal. The room's steps are listed under **More for this room**, **Sharing and people**, where **Add a step** adds another. ## Follow a room 1. Open the room and select **More for this room**. 2. Select **Activity**. It shows who opened the room, what they read and for how long, and the **Questions to answer**. 3. Answer a question there. The visitor sees the answer beside their question in the room, and is emailed it when email is set up. To close a room, select **More for this room**, **Unpublish**. Every link to it says the room has closed, at once. Publish it again and each link opens as it did. ## Troubleshooting ### "This space does not allow sharing outside the organisation." The space's managers have not turned on **Sharing outside**, or the space's type does not allow it. Ask someone who manages the space. ### "Checking an address needs email" or "Needs email, which ... is not set up" Email is not set up on the server, so Library cannot send codes. Share with **A link** without **Ask for their email address**, or ask whoever runs the server to set up email. ### A page cannot be ticked for a room or shared The page's reason is shown beside it. A file that holds something shaped like a credential, or that Library could not read, waits until someone who can manage Library releases it. A page marked internal or confidential cannot go in a room. A page in the trash is not shared until it is restored. ### "Add what the room shows before publishing it." The room has no items yet. Add at least one document, then publish. ### "No room can show this page yet" A room shows pages from its own space and from spaces that let rooms show theirs. Select **New room** in that dialog to make a room for the page.