> For the complete documentation index, see [llms.txt](https://tiscad.gitbook.io/tiscad-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://tiscad.gitbook.io/tiscad-docs/installation-and-setup/first-time-setup.md).

# First-Time Setup

After installing QuickInsert and enabling the add-in in SOLIDWORKS® , you’ll need to complete the **initial setup** before using the tool.

This includes:

* Activating your license
* Setting a valid folder for storing fastener parts
* Optionally customizing your user profile, language, or naming conventions

***

### 🔐 Step 1: Activate Your License

When QuickInsert runs for the first time, it checks for an active license.

If no license is active, you’ll see the following popup:

> ❗ *"No valid license found. Would you like to activate your licence now?"*\
> ✅ **Yes** → Opens the **License Activation Form**\
> ❌ **No** → Closes the message (QuickInsert features will remain locked)

You have two options:

#### [Option 1: Enter Your License Key](/tiscad-docs/licensing/activating-your-license.md)

If you've purchased a license, paste your key into the form and click **Activate**.

#### [Option 2: Request a Trial](/tiscad-docs/licensing/starting-a-free-trial.md)

Click **Request Trial**, fill in your name, email, and company, and your trial license will be activated automatically.

***

### 📂 Step 2: Define Output Folder for Fasteners

Once the license is active, QuickInsert will check the **folder path** defined in your current user profile. This is where generated fasteners will be saved.

If:

* the folder is **missing**
* not yet defined
* or is **unavailable (e.g., removed or disconnected network drive)**

You will see this prompt:

<figure><img src="/files/eOBnrr38x4IuP5sysGbN" alt=""><figcaption></figcaption></figure>

> ❗ *"QuickInsert - Active user profile save location issue.* \
> *Would you like to select a different save path now?"*\
> ✅ **Yes** → You will be automatically transferred to the **Database Administration Form**\
> Specifically, the **Profiles and Naming** tab will open, and the **Browse Folder dialog** will appear immediately\
> ❌ **No** → Folder path remains unset (you won’t be able to insert fasteners)

***

#### 📂 How Folder Assignment Works

In the **Database Administration Form > Profiles and Naming**, use the folder browser to select where QuickInsert should store fastener components.

<div align="left"><figure><img src="/files/4IsWdGuhCmBjsmx51aQx" alt=""><figcaption><p>Browse for "Root folder path"</p></figcaption></figure></div>

* After selecting a folder, click **Save**.

<div align="left"><figure><img src="/files/d6ztbkiOUEzMJsktMgaS" alt=""><figcaption><p>Click save button to store all modified data</p></figcaption></figure></div>

#### ⚠ Important Notes:

* On a **fresh installation**, each user profile will display:\
  `"No output folder defined."`
* If **any profile** still shows that message when setting the path,\
  ✅ **All profiles will be updated** with the new path.
* However, if the path is already set (but unavailable) and you change it,\
  🚫 **Only the selected profile will be updated** — others will remain unchanged.

***

### 🎛 Optional: Customize Profile Settings

Inside **Profiles and Naming**, you can also:

* **Rename profiles** (except the default `"Default"` profile)
* **Add or remove profiles** (Default cannot be removed)
* **Set profile language** (e.g., English, Croatian)
* **Define priority scheme** (for sorting components)
* **Customize part naming**
* **Define folder structure** (flat or nested)
* **Set or update save path manually**

These options help you adapt QuickInsert to your preferred workflow or company standards.

***

### ✅ You're All Set!

You’ve now completed the initial setup.\
Next, start using QuickInsert by following the steps in:\
\
👉 [Using QuickInsert](/tiscad-docs/using-quickinsert/inserting-fasteners-basic.md)


---

# 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://tiscad.gitbook.io/tiscad-docs/installation-and-setup/first-time-setup.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.
