# How modules work

What a module is, how modules share records, who sees them, and where they come from.

Everything your people do in Data Visions happens in a **module**: Time Tracking, Work Orders, Equipment, HR, Accounting. A module is a complete tool for one job, with its own screens, records, AI assistant and help. You add the modules your company needs, and they work together as one system.

[Open the Marketplace now](/tenant/?open=settings/marketplace)

## One workspace, many modules

- **Your data stays yours.** Every module runs inside your own workspace and keeps its records in your workspace's own database. No other company can reach them.
- **Modules work together.** A module can use another's records: Field Services reads your Customers, Payroll reads Time Tracking. A module's **Works with** tab lists what it uses and what uses it. Some need another module to work; others just do more when it's there.
- **Packages** bundle the modules a kind of business usually needs, such as Construction & Field Services, so you can install them together.

## Who sees a module

Installing a module adds it for the whole workspace, but each person sees it only if one of their roles allows it.

- Every module brings its own **permissions**, such as *read*, *create*, *approve* or *manage settings*.
- The **Admin** role gets them as the module recommends. **Your own roles get nothing automatically**: after you install a module, give its permissions to the roles that need it.
- Someone with none of a module's permissions doesn't see it in their sidebar at all.

See *Roles and permissions*.

## Settings, versions and help

- **Settings.** Click the **⋮** on a module's row in the sidebar to set it up for your company: its own settings, the wording of messages it sends, and its preferences.
- **Versions.** Modules are updated over time. **Preferences** lists every version; you can roll back to an earlier one if an update causes trouble. Your data is kept either way.
- **Help.** Every module has **Help** with how-tos and step-by-step guides, and an **AI assistant** that knows the module and acts only as far as your role allows.

## Where modules come from

| Label in the Marketplace | What it means |
|---|---|
| **Reviewed** | Checked by Data Visions before it was listed. |
| **Private to your workspace** | Built by your own people with the Module Builder. Only your workspace can install it. |
| **Shared with you** | Another workspace made it available to yours. |
| **Modified copy** | Your workspace changed its copy of a listed module. |
| **Your own copy** | Your workspace bought its own copy: you can change it, and it takes no updates from its creator. |

Your own modules are listed first. To build one, see the **Creators** section.

## Subscribe or own a copy

Each module's creator decides how workspaces get it: by subscription, as your own copy, or both. Subscribing gets you new versions from the creator, but you can't change the module. When the creator offers it, **Customize it** (or **Buy your own copy**) makes it yours: change it with the Module Builder or check it out with the CLI or Claude, and pay no monthly charge, but no more updates reach it. See [Marketplace: buy your own copy of a module](article:3bb3df7d-c03a-4e8e-97fc-27090d303a98).

## Removing a module

Unsubscribing takes a module out of the sidebar and stops it running. Its records stay and come back if you subscribe again. For a test install you can delete its data instead; it's backed up first.

**Next:** Add or remove a module · Module settings and versions · Arrange the sidebar


Source: https://datavisions.ai/docs/system-settings/modules/how-modules-work
