> For the complete documentation index, see [llms.txt](https://docs.enercalc.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.enercalc.com/efr-user-manual/setup-and-interface/linking-a-revit-project-to-ene/basic-file-linking.md).

# Basic File Linking

How to link a Revit project to an ENERCALC .EC6 file for storing calculations through the Preferences menu.

ENERCALC for Revit is driven by manually connecting a Revit project to one or more ENERCALC project files (extension “`.EC6`”) where calculations will be stored. Within a particular Revit project, the following guidelines apply to this process:

* At any given time, an individual user is allowed only **one** linked `.EC6` file.
* Any number of unique individual users may specify their own linked `.EC6` file.
* ENERCALC for Revit identifies individual users via the unique combination of Windows account username and computer name

Any `.EC6` file that is linked to a particular Revit project will be automatically associated with the identity of the specific user who linked it. This identity is expressed in the format “username\_machine name”. The username used for this identity is the user’s account username on their local machine, not their Autodesk Revit account username.

The process of specifying this `.EC6` file is managed from the ENERCALC for Revit preferences menu.

![](https://4249100372-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgHVzpA9PT0VcuNGp6j39%2Fuploads%2Fgit-blob-caa67154fd717d21ba295139b24989abf2bee487%2Fclip0030.png?alt=media)

When the Preferences menu launches, the rest of the Revit interface will remain frozen. The form is organized into two main tabs: “Current Session” and “Active Model”.

![](https://4249100372-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgHVzpA9PT0VcuNGp6j39%2Fuploads%2Fgit-blob-bb61efe335e864a62c13aabbfd163f37544bade1%2Fclip0031.png?alt=media)

Navigate to Preferences > Active Model Preferences > File Linking. At the top of this tab page, the identity of the current user is indicated. Any file linking changes made here will only impact the current user, whose identity is noted.

![](https://4249100372-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgHVzpA9PT0VcuNGp6j39%2Fuploads%2Fgit-blob-b2de59e41bd92fd7fe00e836510468acaec59bb4%2Fclip0032.png?alt=media)

Below the user identity is a textbox showing the ENERCALC Structural Engineering Library (`.EC6`) file that the current user has specified for storing ENERCALC SEL calculations. If no file path is shown, then the current user has not yet linked a file.

![](https://4249100372-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgHVzpA9PT0VcuNGp6j39%2Fuploads%2Fgit-blob-24548f90de9f601d00af63076283ffc48d9769a6%2Fclip0033.png?alt=media)

To set or change the linked `.EC6` file, click the “Change ENERCALC File” button and use the file browsing dialog to choose an `.EC6` file.

![](https://4249100372-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgHVzpA9PT0VcuNGp6j39%2Fuploads%2Fgit-blob-4eb44e3c98d438638b8b9478a835a9695f0a2363%2Fclip0034.png?alt=media)

It is recommended that `.EC6` files be selected from local drive locations if possible. Network drives and file backup services such as Dropbox or similar may not perform as desired. ENERCALC for Revit does not support cloud-stored files at this time.

After selecting an `.EC6` file to connect to, use the “Apply” button in the lower left corner of the Preferences menu to save your changes. Closing the menu without clicking “Apply” will trigger a warning if changes are found. You may click “Yes” to apply and close, or “No” to discard the Preference changes.

![](https://4249100372-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgHVzpA9PT0VcuNGp6j39%2Fuploads%2Fgit-blob-2748d82e910e94a4f4ac440a78b5188e1cc0d7bc%2Fclip0035.png?alt=media)

Once the Preference changes have been applied, the Revit model is ready for new calculations to be created. All new calculations created by the current user will be stored in the currently specified `.EC6` file. If the `.EC6` file is changed in the future, all previously created calculations will remain in the original `.EC6` file, but future calculations will be created in the newly specified file.

Note that it is **NOT NECESSARY** for a particular `.EC6` file to be used ONLY for Revit-linked calculations. Users may choose to specify an `.EC6` file that already contains conventional non-Revit-linked calculations. These existing calculations will remain in the file and will be fully functional just as they were prior to the file being linked to Revit.

The currently specified `.EC6` file may be directly viewed in its actual folder location using the “View in Folder” button. Clicking this button will launch a new Windows File Explorer window with the location of the current linked file.

![](https://4249100372-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgHVzpA9PT0VcuNGp6j39%2Fuploads%2Fgit-blob-a3054249ce4aa91a061501a5e065f272a179dc54%2Fclip0036.png?alt=media)

When a user accesses the Preferences menu and specifies an `.EC6` file for linking, the file is by default associated with the identity of the specific user who selected it. A summary of this information for all users who have linked a file can be viewed using the “Show Linked File Table” button.

![](https://4249100372-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgHVzpA9PT0VcuNGp6j39%2Fuploads%2Fgit-blob-e6b5ee3e56d944a1eb148cf40741c8ba514a1417%2Fclip0037.png?alt=media)

![](https://4249100372-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgHVzpA9PT0VcuNGp6j39%2Fuploads%2Fgit-blob-882051ac3152cd09aa4ca2d8ea39d6741eadd205%2Fclip0038.png?alt=media)

Once visible, the expanded list may be hidden with the “Hide Linked File Table” button.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.enercalc.com/efr-user-manual/setup-and-interface/linking-a-revit-project-to-ene/basic-file-linking.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
