When a guide is published, it is available for users to download. You can promote it to your users so they can find and access your content.
When you submit your guide to be published it needs to be approved. Your guide will be published to a space. The owner of the space needs to approve your guide. You may wish to contact the organization admin prior to clicking submit so they know to approve your guide.
For guides published to the Guidebook app, please keep in mind that it may take up to two days for a guide to be approved.
If you are an organization admin and you would like to learn how to approve your organization's guides, please click here.
Publishing a Guide
As you add content your guide, Builder will provide you with progress updates. You will see prompts to fill out menu items on the right-hand side of the guide-building screen.
When your guide is ready to be published, you will see a blue Submit guide button.
If you don’t see this button, it is likely that you have a list of action items that must be addressed. This may be an empty guide module or a feature beyond your current plan level. Either add content to the blank menu item, unpin the schedule track, disable the feature, or remove it. For a feature that requires an upgrade, click Upgrade, or remove the menu item.
When you click Submit guide, ensure your guide’s basic details are correct.
Once you publish your guide, your guide name, short name and duration will be locked in.
You can continue to edit all other content. If you need to change the name, short name, or dates post-publish, please reach out to email@example.com.
You will then be asked where your guide should live. Select the space(s) to which your guide will be published.
Builder will send an attachment request email to the org admins who will review your guide.
If you select multiple spaces, please keep in mind that each attachment request will need to be approved by each org admin separately.
You can select the Guidebook space, spaces you personally own, and spaces owned by the organization you're a member/admin of. If you would like to create a new space/app and publish there, please reach out to firstname.lastname@example.org.
Guide Approval Process
Once your guide is submitted, you can continue to make changes to your content. You should expect to receive a message from Guidebook Support and/or your organization administrator about the status of your guide attachment request. It will be either approved or rejected.
- Approved: Your guide has been published to the space(s) you selected. You're ready to promote your guide to your users.
- If you are attaching to a single-guide app, the app will require resubmission before the guide is accessible.
- Rejected: You will receive an email with brief details explaining why your guide has been rejected. You can edit your guide and resubmit it for approval as many times as needed until it's ready to be shared with your end-users.
Once your guide is approved it's time to tell people about your guide. Visit the Promote section of your guide and make use of our promotional best practices document for ideas on sharing download instructions.
After your guide has been published for the first time, you can continue to make changes to it right up to, during, and even after the event. In order for people to see those changes on their mobile device, you’ll need to publish a guide update.
Once you make a change in your guide, you'll see a blue button on the right in Builder, or on the left in the guide dashboard. You'll only see those buttons once you make a change.
Viewing Updates In-App
The guide will update in-app under the following circumstances if your device is connected to the internet:
- Anytime the guide or app is opened after being closed.
- Within five minutes when you navigate to a different menu item.
After clicking the Publish Updates button on your computer, it takes about five minutes for the update to be available on mobile.
An update is automatically applied when the guide is re-opened. If you are viewing the guide when the update comes through, you'll see a pop-up to Update now. You can choose to tap the button or tap in the background to ignore the update. If you ignore the update, you can open the navigation menu and tap the Update now button there.
If you get an automatic update, or select to Update now, you’ll see a bar loading across the top of the screen, an “Applying Update” message in the middle, and finally an “Update complete” message along the bottom of the screen. The update process looks slightly different on Android, but operates the same way.
My update is taking a long time.
It takes about five minutes for updates to propagate from Builder, through servers, and to mobile devices. Navigating between menu items will prompt an update if one is ready.
I’m not seeing the publish updates buttons, where is it?
If you’re not seeing the publish updates button(s), it’s because you have some action items you need to take care of before publishing. You’ll see a list on the right in Builder that will show you the outstanding issues.
Another reason you wouldn’t see the publish updates button is if you haven’t made any updates yet. Go ahead and make a change to the guide and the button will appear.
If you are still not seeing this option, it may be that your guide is no longer publishable. If you create a guide with a start date and an end date (i.e., for an event), your guide will become archived two weeks after the guide’s end date and you can no longer publish updates.
If you have a question about your guide's status, please review this article here.
I received an error when clicking publish updates. Help!
If you get an error when publishing updates, try refreshing your browser. Another collaborator or an automated process (such as changes via our API) may have already published changes.