Pangur docsPublish, protect and take down an exhibition
Publishing makes an exhibition's draft its public page. This page covers publishing for anyone or behind a password, changing the address or your handle, taking a page down, deleting it, and the limits that apply.
Publishing makes an exhibition's current draft its public page. This page covers the choices you make when you publish and afterwards: who can read the page, what its address is, and how to take it down or delete it. How drafts and snapshots relate, and the steps for a first exhibition, are in Make an exhibition. Exhibitions are not offered on every account or deployment.
Before you publish
You need a public handle, which is the name in your address. Claim one at the top of the Publish list or in Settings, under your profile; until you have one, publishing is refused. An exhibition in an organisation project uses the organisation's handle instead, as described below.
Visitor view on the canvas bar shows the page as it will be published, built from the current draft.
Publishing an exhibition
You can publish from two places. Publish on the canvas bar makes the current draft the public page, readable by whoever could read it before: anyone, for an exhibition published for the first time. Settings on the canvas bar lets you choose who can read it, Anyone or With a password, before you choose Publish.
When you publish, Pangur's server first checks that your plan allows another live exhibition (see Limits) and that there is a handle to publish under. It records who may read the page, storing only a hash of any password. If the exhibition has no images, recordings or videos, it makes the snapshot at once and the status becomes Published. If it has media, the status becomes "Publishing…" and a background job copies each file from your library into Pangur's publishing store, skipping files that were copied for an earlier publish and have not changed. The workspace checks progress every few seconds while this runs.
If any file cannot be copied, the exhibition stays in Publishing… with the file's error listed, and the page does not go live, because a page is never published with a missing image. The errors are:
| Message | What to do |
|---|---|
| The file is larger than the {N} MB limit. | Use a smaller file. Images can be up to 25 MB, audio and video up to 500 MB. |
| There is no space left for published media on this account. Remove media from other exhibitions first. | Remove media from other exhibitions, then publish again. |
| The library this file came from is no longer connected. | Replace the file with one from a project that still exists, or remove the block. |
| This attachment has no stored file. | Choose another file. |
If Pangur cannot reach your library while publishing, it says so with the reason, and you try again later.
View live opens the public page once it is published.
Publishing again after changes
The public page shows the snapshot from your last publish. After editing the draft, choose Publish again, on the canvas bar or in Settings, to make a new snapshot. A password-protected exhibition stays protected, with the same password, and visitors who have already entered it can go on reading. Pangur keeps earlier snapshots, but the workspace has no control for going back to one.
Protecting an exhibition with a password
- Choose Settings on the canvas bar.
- Under who can see it, choose With a password.
- Type the password in Password. For an exhibition that already has one, the field is New password: leave it empty to keep the current password.
- Choose Publish, or Publish again if the exhibition is already live.
A visitor to a protected exhibition sees only its title, a note that the exhibition needs a password, a Password field and Open. A wrong password is refused, and after 10 attempts from one address within five minutes Pangur refuses further attempts for a while.
Once a visitor has entered the right password, their browser can read the exhibition for 12 hours. To change the password, type a new one in New password and publish again. A new password ends every visitor's access, so they must enter the new one; publishing again with the same password, or with the field left empty, does not. To remove the password, choose Anyone and publish again.
Protected exhibitions are kept out of search engines and Pangur's sitemap, and your public page lists them as needing a password to view. Their images and recordings are served only to visitors who have unlocked the page.
Changing an exhibition's address
The address, or slug, is the exhibition's part of its URL. It is made from the title when you start the exhibition, and if another of your exhibitions already has that address Pangur adds -2, -3 and so on.
To change it, open Settings, edit Address (slug) and choose Save details. The same form changes the Title, Subtitle and Introduction (markdown).
For an exhibition that has already been published, Pangur remembers every earlier address, and after the next publish, links to an old address redirect permanently to the new one.
Changing your handle
Your handle is set in Settings, under your profile, and you can change it there. Pangur does not keep a record of earlier handles, so links that use the old handle, whether to your public page or to any of your exhibitions, stop working when you change it, and another person can then claim the old handle.
Publishing under an organisation's handle
Exhibitions made in an organisation's project are published under the organisation's handle, at pangur.io/{handle}/, which the organisation's admins choose on the organisation's page. Until they have chosen one, publishing fails with a message asking you to have an admin choose it. Your own public page lists only your exhibitions from outside organisation projects. Organisations are described in Work in an organisation.
In an organisation project, editors and owners can publish and change the project's exhibitions, and viewers can read them (see Project members and roles).
Taking an exhibition down
Take down in Settings, which appears once the exhibition is published, removes the public page at once. Its address, and its images and recordings, return "not found", exactly as for an address that never existed, and the status becomes "Taken down". The draft and earlier snapshots are kept, so publishing again puts the page back at the same address.
Deleting an exhibition
Delete exhibition in Settings asks you to confirm and warns that the exhibition and its public page are removed with no undo. Deleting removes the draft, every snapshot and every saved arrangement, and the media files that no other exhibition uses.
Limits
| Limit | Value |
|---|---|
| Live exhibitions on the Free plan | 1 at a time |
| Live exhibitions on the Researcher and Institution plans | No limit |
| Image file | 25 MB |
| Audio or video file | 500 MB |
| Published media for one account | 2,048 MB in all |
On the Free plan, publishing a second exhibition is refused with "The Free plan keeps 1 exhibition live at a time. Unpublish one first, or move to the Researcher plan." Exhibitions in organisation projects do not count towards your own plan's limit. Your number of live exhibitions is shown on the Usage page as "Live exhibitions", and media files also count towards your storage. These figures are the defaults, and Plans, limits and usage is the reference for them.
Publishing from the iPhone, iPad or command line
The iPhone and iPad app publishes with Anyone or With a password, takes an exhibition down, and has View public page, Share link and Copy link. Visitor view in the app opens the web preview.
The command line publishes and takes down exhibitions:
pangur exhibitions list
pangur exhibitions publish EXHIBITION_ID --visibility password --password 'a passphrase'
pangur exhibitions unpublish EXHIBITION_ID--visibility accepts public, the default, or password. As with the canvas bar, publishing again without --visibility password makes a protected exhibition public. unpublish keeps the draft. The commands are listed in the command-line reference.
Assistants connected over MCP cannot publish, take down or delete an exhibition. If asked, they are told to ask you to do it in Pangur.
Exhibition blocks
This reference describes every kind of block an exhibition section can hold, with its fields, its limits and the moment at which its content is fixed for the public page.
Share references
A share gives named colleagues read access to one or more references from your library, with their files and notes. This page explains how to create a share, what the invited person sees, and how a share differs from other ways of giving access.