# Custom Access

<p class="doc-lead">Custom Access grants a specific user permission to a record or action on a collection without changing their role. Use it for one-off exceptions (e.g. access to one customer's transactions).</p>

<div class="doc-toc">
<p class="doc-toc-title">On this page</p>
<div class="doc-toc-section">
<div class="doc-toc-links">
<a href="#/settings/custom-access?id=overview">Overview &amp; List View</a>
<a href="#/settings/custom-access?id=quick-start">Quick Start</a>
<a href="#/settings/custom-access?id=fields">Fields</a>
<a href="#/settings/custom-access?id=actions">Actions</a>
<a href="#/settings/custom-access?id=faq">FAQ</a>
<a href="#/settings/custom-access?id=related">Related</a>
</div>
</div>
</div>

<hr class="doc-section-divider">

<h2 id="overview">Overview &amp; List View</h2>

Go to <b>Settings → Custom Access</b> from the left menu.

<!-- screenshot pending -->

<b>List columns</b>

| **Column** | **Description** |
|------------|-----------------|
| Id | Record ID. |
| Collection | ERP entity (module/document type). |
| Action | Permission action granted (e.g. View, Edit). |
| Owner | User who receives the access. |

<b>Filters</b>: Collection (contains/equals), Created Date.

<b>List actions</b>: New, View, Edit, Delete (multi).

<hr class="doc-section-divider">

<h2 id="quick-start">Quick Start</h2>

<h3>1. Navigate</h3>
Go to <b>Settings → Custom Access</b> and click <b>New</b>.

<h3>2. Define access</h3>
Select <b>Collection</b>, <b>Action</b>, and <b>Owner</b> (user).

<h3>3. Save</h3>
The user gains the extra permission in addition to their role.

<hr class="doc-section-divider">

<h2 id="fields">Fields</h2>

| **Field** | **Description** |
|-----------|-----------------|
| Collection * | Target entity or document type. |
| Action * | Specific permission to grant. |
| Owner * | User who receives custom access. |

<hr class="doc-section-divider">

<h2 id="actions">Actions</h2>

New, View, Edit, Delete — standard list CRUD.

<hr class="doc-section-divider">

<h2 id="faq">FAQ</h2>

<p><b>Custom Access vs User Role?</b></p>
<p>Roles define broad module permissions for many users. Custom Access adds a targeted grant for one user on one collection/action.</p>

<p><b>Can Custom Access remove a role permission?</b></p>
<p>No. Custom Access only adds grants. Restrict access by editing the user's role or using data filters on User Settings.</p>

<p><b>When should I use Custom Access?</b></p>
<p>Use for one-off exceptions — e.g. allow a user Approve on purchase orders without cloning an entire role for one person.</p>

<p><b>Does Custom Access override branch filters?</b></p>
<p>No. Data filters on User Settings still apply. Custom Access adds module actions only.</p>

<p><b>Can I grant Custom Access on reports?</b></p>
<p>Yes when the collection appears in the Custom Access form — select user, collection, and allowed actions.</p>

<hr class="doc-section-divider">

<h2 id="related">Related Topics</h2>

<ul>
<li><a href="#/settings/user-role">User Roles</a></li>
<li><a href="#/settings/user-management">Users</a></li>
</ul>
