> For the complete documentation index, see [llms.txt](https://docs.scaleflex.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.scaleflex.com/digital-asset-management-dam/plugins-and-connectors/plugins/chrome-asset-picker-extension.md).
# Chrome Asset Picker extension
The **DAM Asset Picker** extension seamlessly integrates your Scaleflex Digital Asset Management (DAM) library into your daily workflow. It allows you to select and upload assets directly from your DAM to any website, bypassing the need to download files to your local computer first.
### Overview
Key capabilities:
* **Universal Interception**: Automatically detects file upload buttons on websites.
* **Direct Integration**: Select assets directly from your Scaleflex DAM.
* **Flexible Authentication**: rigorous security with OAuth 2.0 or Security Templates.
* **Smart Filtering**: Customize which sites the extension interacts with.
### Prerequisites
To use this extension, ensure you have:
1. A **Google Chrome** browser (version 88 or later).
2. An active **Scaleflex DAM** account.
3. *\[Optional]* Your **DAM Token** & **Security Template ID** if using the Security Template authentication.
***
### Installation
1. Open the **Chrome Web Store**.
2. Search for **"Scaleflex DAM Asset Picker"** (or click [here](https://chromewebstore.google.com/detail/scaleflex-asset-picker/ncljemkjljnjmkeddpecohlhnnhekmpk)).
3. Click **Add to Chrome**.
4. Confirm the installation by clicking **Add extension** in the pop-up.
{% hint style="info" %}
**Tip**: For quick access, pin the extension to your toolbar! Click the puzzle icon in Chrome's toolbar, then click the pin icon next to "DAM Asset Picker".
{% endhint %}
***
### Setup & Configuration
To use the extension, you need to connect it to your Scaleflex DAM account.
#### 1. Access Settings
Click the **DAM Asset Picker icon** in your toolbar and select **Settings**.
Note that even if Connected, you can prevent the DAM Asset Picker to open by Globally Disabling it with the button accessible in that toolbar.
#### 2. General Preferences
Customize how the extension behaves in the **General Preferences** tab.
* **Preferred Language**: Choose the language for the DAM interface (default: Auto from browser).
* **Root Folder**: Specify a default folder to open in the DAM widget (e.g., `/marketing/assets`).
* **Excluded Domains**: Add websites where you *do not* want the extension to appear (e.g., your company's internal tools). Separate domains with commas.
#### 3. Authentication
Navigate to the **Authentication** tab in the settings page. You have two ways to connect:
**Option A: OAuth 2.0 (Recommended)**
This is the easiest and most secure method.
1. Click **Login to DAM with OAuth**.
2. A new window will open asking you to log in to your Scaleflex account.\*
3. Grant permissions to the extension.
4. Once successful, the status will change to **Connected** (green dot in tab).
*Note: the Scaleflex DAM OAuth 2.0 flow is a standard flow and does not require any additional configuration. It will allow you to connect using a secure email/password combination as well as various social accounts (Google, LinkedIn, etc.).*
**Option B: Security Template**
Use this if you need to restrict access to a specific scope or do not want to use user credentials.
1. Enter your **DAM Project Token**.
2. Enter your **Security Template ID**.
3. Click **Save & Validate**.
#### Options for the DAM library
You can set your **preferred default options** when opening the Asset Picker, like:
* default sorting
* possibility to select and insert more than 1 asset
* view type (grid or list)
***
### Connection Status
The extension displays your connection status in two places:
#### Browser Toolbar
Hover over the DAM Asset Picker icon in your toolbar to see the current status:
* **"Asset Picker - Not configured"** - Open Settings to set up authentication.
* **"Asset Picker - OAuth connection"** - You're logged in and ready to use the extension.
* **"Asset Picker - Security Template"** - Using Security Template authentication.
* **"DAM session expiring soon"** - Your session will expire soon. Click to renew.
* **"DAM session expired"** - Please log in again to continue.
#### Popup Window
Click the extension icon to see a detailed status view:
* **Green dot** - Connected and ready.
* **Orange dot** - Session expiring soon (within 5 minutes).
* **Red dot** - Session expired or not configured.
#### Session Management
When using **OAuth authentication**, your session is automatically renewed in the background every 55 minutes. If automatic renewal fails (e.g., due to network issues), you'll see the "Session expired" status. Simply click the extension icon and log in again to refresh your session if it expired.
When using **Security Template**, your session is automatically created every time you open the widget, using the saved credentials you provided in settings.
### Using the Extension
#### Uploading Files
1. Navigate to any website with a file upload feature (e.g., Slack, File converter, WordPress, etc.).
2. Click the **Upload** or **Attach File** button on the website.
3. The extension will intercept the click and show you a choice:
* **Local File**: Opens your computer's standard file browser.
* **DAM Library**: Opens the Scaleflex DAM widget.
4. Select **DAM Library**.
5. Browse or search for your asset in the modal window.
6. Select the file and click **Insert**.
7. The file will be automatically uploaded to the website as if it came from your computer.
#### Drag & Drop Support
You can also use drag and drop zones to upload files from the DAM!
1. Place your pointer over a supported drop zone on a website.
2. The extension will highlight the drop zone.
3. Click the zone to trigger the upload choice menu.
***
### Troubleshooting
* **Extension not appearing on click?** Ensure you are not on an **Excluded Domain**. Check your settings to verify, and that the page offers a standard "upload" button (it might not catch a custom javascript based upload).
* **Login failing?** If using **OAuth**, ensure your browser allows pop-ups for the authentication window. If using **Security Templates**, verify that your Token and Template ID are correct and the template is active in your DAM dashboard.
* **Widget not loading?** Check your internet connection. If the issue persists, try reloading the page or reconnecting your account in the Settings. And if still not working, try to disable the extension and then enable it again. Finally, look for other extensions that might be conflicting with the DAM Asset Picker (pop up blockers, etc.).
---
# 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.scaleflex.com/digital-asset-management-dam/plugins-and-connectors/plugins/chrome-asset-picker-extension.md?ask=&goal=
```
`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.