> ## Documentation Index
> Fetch the complete documentation index at: https://docs.stru.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Sharing & Permissions

> Give your engineers, reviewers, and project partners the right level of access to drawings and deliverables: roles, sharing, and access requests

## Give the Right People the Right Access

A project usually isn't a one-person job. The engineer running the review, the drafter fixing the sheets, the PM who just needs to read the findings: each needs a different level of access. In Stru, every file and folder has a **Manage Access** dialog that controls exactly that.

Common setups:

* **Project team**: share the job's [project folder](/how-to/file-management) with your engineers as **Editor** so they can upload sheets and [launch reviews](/how-to/drawing-review).
* **Review-only stakeholders**: add the PM or client as **Viewer**: they can open and download, but nothing changes under them.
* **Whole-company folders**: organization folders can default to everyone in your org, like the shared [Standards folder](/how-to/standards-folder).

Open Manage Access two ways:

* **For the folder you're in**: click **Manage access** in the toolbar at the top right.
* **For any file or folder**: right-click its row (on a trackpad: two-finger click, or Control-click) and choose **Manage access**.

<Info>
  **Everyone you share with needs a Stru account** (signing up is free). Every access level below applies to signed-in users; there are no anonymous, no-login links.
</Info>

<Frame>
  <img src="https://mintcdn.com/struai/aJeDnguak6OWj2zX/images/manage-access-people.png?fit=max&auto=format&n=aJeDnguak6OWj2zX&q=85&s=dafe8ea51a771c954a4a5cbe29b8b5d9" alt="The Manage Access dialog: Add people, People with access with roles, and General access" width="612" height="566" data-path="images/manage-access-people.png" />
</Frame>

***

## The Three Roles

A **role** is what someone is allowed to do with a file or folder:

<CardGroup cols={3}>
  <Card title="Viewer" icon="eye">
    View, preview, and download. Can't upload, change, or run reviews.
  </Card>

  <Card title="Editor" icon="pen">
    Everything a Viewer can do, plus upload, create, rename, move, delete, and launch reviews.
  </Card>

  <Card title="Owner" icon="crown">
    Everything an Editor can do, plus manage who has access and transfer ownership.
  </Card>
</CardGroup>

<Info>
  **Editor applies to the whole folder's contents**: an Editor can rename, move, or delete anything in the folder, not just the items they added themselves. Give Editor to people doing the work; give Viewer to people reading it.
</Info>

***

## Sharing with a Person

<Steps>
  <Step title="Type a name or email">
    In the **Add people** field, type your teammate's name or email. Keep typing to add several people at once; each becomes a chip.
  </Step>

  <Step title="Pick their role">
    Choose **Viewer** or **Editor** for the people you're adding.
  </Step>

  <Step title="Save">
    Your changes collect as a draft. Click **Save changes** to apply them all at once. (The button reads **Done** when there's nothing pending.)
  </Step>

  <Step title="They find it in their Files">
    Your teammate gets an in-app notification, and the item appears inside their own Files tree at its natural location; there's no separate "shared" area to dig through.
  </Step>
</Steps>

<AccordionGroup>
  <Accordion title="Can I share with someone who doesn't have a Stru account yet?" icon="envelope">
    Yes: add their email as usual. They appear as an external invite and get access the moment they sign up with that email. Until then you can still change their role or revoke the invite.
  </Accordion>

  <Accordion title="If I remove someone's access, how quickly does it apply?" icon="bolt">
    Immediately after you save. Their very next action is denied, even in an already-open tab.
  </Accordion>
</AccordionGroup>

***

## General Access: the Default for Everyone Else

Below the people list, **General access** sets what happens for anyone who *isn't* listed individually:

<Frame>
  <img src="https://mintcdn.com/struai/aJeDnguak6OWj2zX/images/manage-access-general-access.png?fit=max&auto=format&n=aJeDnguak6OWj2zX&q=85&s=8ffe6dcfc3fbc97b2b3edfcb9fed9d32" alt="The General access dropdown open, showing Restricted and Anyone with the link" width="618" height="580" data-path="images/manage-access-general-access.png" />
</Frame>

| Level                    | Who can open it                                                                                                    |
| ------------------------ | ------------------------------------------------------------------------------------------------------------------ |
| **Restricted**           | Only the people listed above. A hard boundary, even inside a shared project.                                       |
| **Organization**         | Everyone in your organization, at the default role you pick (Viewer or Editor). Available on organization folders. |
| **Anyone with the link** | Anyone signed in to Stru who has the link can view.                                                                |

On an organization folder, the Organization level pairs with a default role. Here is the shared Standards folder set to org-wide Editor:

<Frame>
  <img src="https://mintcdn.com/struai/aJeDnguak6OWj2zX/images/manage-access-org.png?fit=max&auto=format&n=aJeDnguak6OWj2zX&q=85&s=78de3ff1079bd3fbb6b965bf2beaf58d" alt="An organization folder with General access set to Organization and default role Editor" width="614" height="576" data-path="images/manage-access-org.png" />
</Frame>

Use **Copy link** to grab the item's link for a chat or email; the button confirms with **Link copied**.

<Tip>
  **Need to lock down one subfolder inside a shared project?** Set that subfolder to **Restricted**: the rest of the project stays open to the team, but only the people you list can open that folder. And to exclude a single person from an org-wide folder, set their individual role to **Restricted** in the people list.
</Tip>

***

## Requesting Access

Opened a link you don't have access to? You'll see a **You need access** panel instead of the content:

<Steps>
  <Step title="Choose the access you need">
    Pick **Viewer** or **Editor**, and optionally add a note explaining why.
  </Step>

  <Step title="Send the request">
    Click **Request access**. The owner is notified and you'll see **Request pending**.
  </Step>

  <Step title="The owner approves or denies">
    Owners see incoming requests in **Notifications**, with **Approve as Viewer/Editor** and **Deny** buttons. Approval works like any normal share: the item appears in your Files.
  </Step>
</Steps>

***

## FAQs

<AccordionGroup>
  <Accordion title="Why can't I reference a shared file in chat?" icon="at">
    Referencing a file in a conversation (see [Mentions & Attachments](/how-to/mentions)) requires **Editor** access or higher. If a file was shared with you as Viewer, ask the owner to raise your role.
  </Accordion>

  <Accordion title="Can I hand a folder to a teammate?" icon="right-left">
    Yes: on organization resources, an Owner can open the person's role menu and choose **Transfer ownership**. You keep Editor access after the transfer.
  </Accordion>

  <Accordion title="Who manages organization-wide folders?" icon="building">
    Organization owners and admins hold owner rights on every organization project, so access can always be fixed; an org project can't be orphaned.
  </Accordion>

  <Accordion title="What happens when someone leaves the organization?" icon="user-minus">
    Organization-owned folders and files are unaffected; the departed person just loses access. Their personal folders remain their own.
  </Accordion>

  <Accordion title="Do sharing changes apply instantly?" icon="floppy-disk">
    Changes apply when you click **Save changes**. Until then they're a local draft; closing the dialog without saving discards them.
  </Accordion>
</AccordionGroup>

***

## Next Steps

<CardGroup cols={2}>
  <Card title="File Management" icon="folder-open">
    Set up project folders your way

    [File Management guide](/how-to/file-management)
  </Card>

  <Card title="Drawing Review" icon="clipboard-check">
    Editor access lets you launch reviews

    [Drawing Review guide](/how-to/drawing-review)
  </Card>
</CardGroup>

<Info>
  **Questions?** Email **[support@stru.ai](mailto:support@stru.ai)** or [book a call](https://cal.com/bhosh).
</Info>
