Paper

This document explains Antpocket's Paper feature.

A paper is a tool for publishing a space's product stock as a separate, shareable web page (URL). In the sidebar, it appears as the Shared Pages (Papers) menu in the Records group.

Related menu path

• Records > Shared Pages (Papers) — create a paper, change its title/visibility, copy the share URL, delete

---

1. Why use paper

Viewing product stock inside the Antpocket app requires logging in and entering a space. But that process can be inconvenient or impossible in situations like:

• Wanting to share current stock with people outside the space (trading partners, partner companies, external sales staff, etc.)
• Wanting to check status on a single page in an always-on environment, like a meeting room monitor or tablet
• Wanting to show head office or a warehouse manager only a specific warehouse's stock
• Wanting to restrict access with a password depending on who you're sharing with

Paper solves these situations as follows:

• Each paper has a unique URL ({host}/papers/{uuid}).
• A paper can be accessed with just the URL, without logging in. (depending on its visibility setting)
• A paper always shows the current stock status, not a snapshot from when it was published — it's always up to date.

The two types of paper

Type	What it shows
All product stock (item_amount)	Every product registered in the space, with its quantity summed across all warehouses
Stock by warehouse (place_item_amount)	Only the quantities for the specific warehouse(s) selected (you can select multiple)

Visibility

Key	Name	Description
private	Private	Only space members can view it. (default)
public	Public	Anyone who knows the URL can view it.
protected	Protected	Only space members, or people who know the password, can view it.

---

2. How to use paper

Page path: Records > Shared Pages (Papers)

The page title is My Papers, with the description "Read-only pages that share your stock levels outside the space via a link." at the top. This page lists every paper you've created in this space as cards.

Each card shows:

• Title
• Type: All product stock / Stock by warehouse
• Visibility badge: Private / Protected / Public
• Created date
• View and Share: copy URL buttons
• A three-dot menu (⋮) in the top right: Rename, Access settings, Delete

2.1 Creating a paper

You can create up to 5 papers per person in each space.

1. Click the Create paper button at the top of the page. (If you haven't created any papers yet, you can also use the Create paper button in the middle of the empty page.)
2. In the Create paper window, specify the following.
   • Type: choose either All product stock or Stock by warehouse.
   • Warehouses: shown only when you choose Stock by warehouse. You must check one or more warehouses to show.
   • Title: optional. If left empty, the paper is created as "Untitled", and you can change it later.
3. Click Create to create the paper. A new paper starts with Private visibility.

A paper doesn't freeze data at the moment it's created. It always shows the current inventory management stock status as-is, so any inbound/outbound/adjustment/transfer is reflected on the paper immediately.

2.2 Opening a paper

Click View on a paper card to open the paper's URL in a new tab.

• A paper's URL has the form {host}/papers/{uuid}.
• Since you're a space member, you can always view a paper regardless of its visibility.

2.3 Sharing: copy URL

Click Share: copy URL on a card to copy the paper's URL to your clipboard, with a "Link copied to clipboard." snackbar shown.

You can then share the copied URL via messenger, email, and so on. Whether the recipient can actually view the paper depends on its visibility setting.

2.4 Renaming

1. Click the three-dot icon (⋮) in the top right of the card.
2. Select Rename from the menu.
3. Enter the new title in the Change title window and click Change.

The title can't be empty. A paper created without a title is shown as "Untitled" on its card, so if you're going to create multiple papers, we recommend giving each a title that matches its purpose.

2.5 Setting visibility (access settings)

1. Click the three-dot icon (⋮) in the top right of the card → Access settings.
2. Select one of three options with the radio buttons in the dialog. A description of each option is shown in this dialog as well.
   • Private — only space members can access it
   • Public — anyone with the URL can access it (only the space owner can set this)
   • Protected — only space members or people who know the password can access it (requires the Manage data permission)
3. If you select Protected, the password field below becomes active. Enter a password of 4–16 letters and numbers to share with external users.
   • After 10 wrong password attempts within 15 minutes, password entry is blocked for a while.
4. Click Save to apply.

Choosing a visibility level

• If it's just for internal/team use, keep it Private.
• If it's a public catalog anyone can see, set it to Public.
• To share temporarily with a specific trading partner, use Protected with a password. Once you change the password, the old one no longer works.

2.6 Deleting a paper

1. Click the three-dot icon (⋮) in the top right of the card → Delete.
2. Click Yes in the "Are you sure you want to delete it?" dialog to delete it immediately.
3. A deleted paper's URL is no longer valid. Any link you've already shared externally will be broken, so proceed carefully.

---

3. FAQ

Q. Does creating a paper freeze the data at that point in time?

No. A paper always shows current stock status. When inbound/outbound occurs, simply refreshing the paper page reflects the latest quantities.

Q. If I set visibility to Public, will all our company data show up in search engines?

The chance of someone stumbling onto the URL without knowing it is very low, but keep in mind that anyone who learns the URL can access it. For sensitive internal information, we recommend Protected with a password, or Private.

Q. Can other members manage a paper I created?

The My Papers page only shows papers you created. So renaming, changing visibility, and deleting must be done by the author themselves. Viewing (accessing the URL) of the paper itself is possible according to its visibility setting.

Q. What happens to a paper when the member who created it leaves the space?

When a member is removed from the space or leaves it, the papers that member created in this space are deleted as well, and their shared links will no longer open. If a paper still needs to be shared, have a remaining member create a new one and share the new link.

Q. Can I embed a paper on an external site or wiki?

The simplest approach is to share the URL Antpocket provides directly, or load it via an iframe in an external tool.

---

Appendix: Glossary

Term	Description
Paper (paper)	A shareable web page, published at a separate URL, showing a space's product stock.
All product stock	A paper type showing every product's total quantity across all warehouses (item_amount).
Stock by warehouse	A paper type showing only selected warehouses (place_item_amount).
Private	A visibility level accessible only to space members.
Public	A visibility level accessible to anyone who has the URL.
Protected	A visibility level accessible to space members or people who know the password.
uuid	The unique identifier assigned to each paper, included in the URL path.