Confirming what version you are about to share or export
Before you test access, make sure you are looking at the correct version record in Atloria. Open your project, go to the documentation versions area, and select the version you plan to share or send through an export workflow. On the version details page, check the version name or number shown in the page header, then confirm the title and current status shown on the same screen. If your team keeps several versions open at once, this quick check helps you avoid validating the wrong release.
Pay close attention to the version status. A version marked as draft, in review, approved, published, or archived can behave differently when you try to share it or include it in an export process. If you already worked through visibility setup in Managing Version Visibility and Reader Access, use that as your baseline and focus here on confirming the final state of the exact version in front of you.
Next, review the version’s visibility area. Look for the section that shows whether access is controlled by audience settings, reader restrictions, or public availability. You want to confirm the current access mode before you test links, previews, or export options. A version that is visible only to selected readers should not be validated the same way as a version intended for public documentation.
It also helps to decide the destination before you continue. In practice, most checks fall into one of these paths:
| Destination | What to confirm first |
|---|---|
| Internal readers | Audience and reader visibility |
| External readers | Public or limited-access settings |
| Public link | Public visibility and published state |
| Export workflow | Export eligibility and included content |
Checking audience targeting and reader visibility rules
Once you have the correct version open, move to the area where Atloria shows visibility or audience settings for that version. Review every audience, team, group, or role currently assigned. Do not assume the settings are correct because a previous version used the same audience. Even small differences between versions can change who can open the content.
Compare the assigned audience list with the people who are actually meant to receive the version. For example, if the version is meant for internal contributors only, make sure it is not also available to broader public readers. If it is meant for a customer-facing release, confirm the intended audience is included and any internal-only audience is excluded. This is especially important when a version is being prepared for public sharing or export, because the wrong audience setting can expose content too widely or block the right readers entirely.
Also review whether the version inherits restrictions from a higher level in Atloria, such as the project or another parent area that controls access. A version can look correctly configured on its own screen but still be limited by broader visibility rules. If the version is unexpectedly hidden, inherited restrictions are one of the first things to check.
Finally, verify the public access state. If Atloria shows that public access is disabled, limited, or enabled, make sure that setting matches your intended use. For example:
- Disabled fits internal-only review.
- Limited fits controlled sharing with selected readers.
- Enabled fits public documentation access.
If anything looks unfamiliar, stop here and correct the audience setup before you test with reader accounts. Access validation is only useful when the underlying visibility rules match the release plan.
Testing access as the readers who will receive the version
After reviewing the settings, test the version from the reader’s point of view. In Atloria, use any available preview or reader-view option on the version screen to see how the content appears outside the editing context. The goal is not just to confirm the page opens, but to confirm the right people can discover and use it the same way they will after sharing.
- Open the version in preview or reader view.
- Check the page title, navigation, and visible content sections.
- Confirm the version appears as expected for the intended audience.
- Repeat the test with representative reader accounts if your team uses different access levels.
- Try both normal navigation and a direct link to the version.
When possible, test with real examples from each audience you plan to support. That may include an internal contributor, a project administrator, or an external viewer. You do not need to test every single person individually, but you should test enough account types to confirm the visibility rules behave correctly across roles.
Do not rely on only one entry point. A version may be hidden from navigation but still open from a copied link, or it may appear in search but not in the expected menu. Check all of the following if they are available in your Atloria workspace:
- Search results
- Navigation lists
- Version lists
- Direct-link access
Just as important, test the blocked experience. Readers who should not have access should see the expected restricted or access-denied result. If a restricted account can still open a bookmarked link, your visibility setup is not ready.
Verifying the version is ready for public sharing or export workflows
Before you click any share or export action, open the share dialog or export panel for the version and confirm that Atloria allows the action you intend to use. If the option is unavailable, that usually means the version does not yet meet one or more release conditions. Check the current status shown on the version page and compare it with your team’s release process.
- Open the version’s Share or Export area.
- Confirm the intended action is available.
- Review the version status and approval state.
- Check whether required metadata is complete.
- Verify included content before sending or exporting.
For public sharing, confirm the version is in the right state for external access. If your team requires approval before public release, make sure that approval is already recorded. For export workflows, verify that any required labels, version details, or release information used in exported output are complete on the version record before you continue.
Also review everything the version depends on. A version may look correct on screen while still containing attachments, embedded items, or linked pages that are not available to the same audience. If exported output is part of your workflow, confirm those items are included correctly and will not disappear for the recipient.
Use this final check before proceeding:
| Item to verify | What to look for |
|---|---|
| Share option | Available for the current version |
| Status | Matches your release stage |
| Approval | Completed if required |
| Metadata | Filled in where needed |
| Attachments and linked content | Accessible or included in export |
This is the point where you confirm not only that the version can be shared, but that it will reach the right audience in the right form.
Recording and approving the final access check
A final access check is much easier to trust when it is documented. After testing the version in Atloria, record the result in the version’s review notes, approval area, or whichever release-tracking space your team uses. Keep the record tied to the exact version so anyone reviewing the release later can see what was checked and when.
Include the details that matter for future review. At minimum, note the version name or number, the audiences you confirmed, the reader account types you tested, and the date of the check. If your team uses approval markers or release statuses, update them at the same time so the version clearly shows that access validation is complete.
A useful record usually includes:
- The exact version reviewed
- The intended audience or sharing target
- Which reader views were tested
- Whether direct-link access was checked
- Whether restricted readers were blocked correctly
- The date of validation
- The name of the person who performed the check
If Atloria supports comments or sign-off notes in your version workflow, add a short note describing the outcome. Keep it specific, such as confirming that the published version was visible to the intended audience and hidden from non-target readers. Avoid vague notes like “looks good,” which do not help during later audits or release reviews.
Screenshots can also help. Capture the visibility settings, audience assignments, and at least one successful reader-view test. If your team needs release evidence, these images make it easier to show that the version was checked before sharing or export.
A repeatable record keeps each release consistent and reduces confusion when multiple people handle approvals.
Fixing visibility problems before sharing or exporting
If your validation check uncovers a problem, fix it before sending the version anywhere. The safest approach is to return to the version details page, review the visibility settings again, and correct the issue at the source rather than trying to work around it with a copied link or manual explanation.
When the version is not visible to the intended audience, first recheck the assigned audiences and any broader project-level restrictions that may still be limiting access. Also confirm the version is in the right status. A draft or archived version may not be available in the same way as a published version, even if the audience settings look correct.
If readers can open a direct link but cannot find the version in search or navigation, review how the version is listed. In Atloria, visibility is not always the same as discoverability. A version may technically be accessible while still missing from the places readers expect to browse. Check the navigation placement, listing behavior, and whether the version is appearing in the correct version or documentation lists.
If the public share or export action is unavailable, open the version again and confirm it meets the required conditions. Common blockers include the wrong status, missing approval, or missing release details needed for the selected workflow. If your role does not have access to the action, you may also need someone with the right permissions to complete the step.
If exported output is missing content, review every attachment, embedded item, and linked page included in the version. Missing content often points to one of two issues:
- The item is not available to the same audience as the version
- The item is not being included in the export result
Do not move forward until the version behaves correctly for both allowed and blocked readers. A clean validation result is more important than rushing the release.
Overview
This guide focuses on the final checks you perform in Atloria before sharing a documentation version with readers or using that version in an export workflow. It assumes you have already set up the intended visibility and audience rules and now need to confirm that those settings work in practice. If you still need to configure the access rules themselves, return to Managing Version Visibility and Reader Access before continuing.
The validation process in Atloria centers on four things:
- Confirming you selected the correct version
- Reviewing audience and visibility settings
- Testing the version as real readers will experience it
- Verifying the version is eligible for sharing or export
This is an important step because version access is not just about whether a page opens. A version can be visible in one place and hidden in another, or available to the wrong audience through a direct link. It can also appear ready for export while still containing linked content that recipients cannot access. By checking the version from multiple angles, you reduce the risk of sending incomplete, restricted, or overly broad documentation to the wrong audience.
You will also use this guide to create a clear record of the final access review. That record is useful for approvals, release coordination, and later audit or governance checks. In teams where several people work on documentation versions, a documented validation step helps everyone understand whether a version is truly ready to leave the project workspace.
After you complete these checks, the next step is Controlling Version Sharing and Export Readiness, where you move from validation into the actual sharing and export decision process.
Prerequisites
Before you start this validation process in Atloria, make sure the version is far enough along in the release cycle to be meaningfully checked. You do not need every downstream action completed, but you should have enough information on the version screen to confirm visibility, audience targeting, and sharing readiness.
You should have the following in place:
- Access to the project and the version you plan to validate
- A version that already has its visibility or audience settings configured
- Enough permission in Atloria to open the version details page and view sharing or export options
- A clear understanding of who the version is intended for, such as internal readers, selected external readers, or public readers
- At least one test account or representative reader type to use during access checks, if your team validates with separate accounts
It also helps if the version already has its current status assigned, such as draft, approved, published, or archived, because that status affects what you can validate. If your team uses approvals, review notes, or release sign-off steps, have those areas ready so you can record the result immediately after testing.
Before beginning, confirm these supporting items as well:
| Needed before validation | Why it matters |
|---|---|
| Correct version selected | Prevents checking the wrong release |
| Audience settings already defined | Gives you real access rules to test |
| Reader targets identified | Lets you compare expected vs actual visibility |
| Share or export goal decided | Changes which checks you need to perform |
If any of these pieces are missing, pause and complete them first. Validation works best when you are checking a real release candidate rather than an unfinished version setup.
Was this page helpful?