Contact Us

If you still have questions or prefer to get help directly from an agent, please submit a request.
We’ll get back to you as soon as possible.

Please fill out the contact form below and we will reply as soon as possible.

  1. Fotoware Alto
    • End-User Manual
    • User Guides
    • Solutions
    • Terminology
    • API Changelog
  2. Fotoware Veloz
    • Managing users and groups
    • Configuring archives
    • Configuring workflows
    • Configuring site behavior
    • Navigating and searching to find your assets
    • Working with your assets
    • Editing asset metadata
    • Uploading files
    • Version Control in Fotoware
    • Albums - Creating and sharing collections
    • Placing assets in a CMS
    • Working with the Fotoware Pro interface
    • Using the Fotoware plugins
    • Consent management
    • User guide to FotoWeb for iPad (Legacy)
    • Picture conferencing with FotoWeb Screens (Legacy)
    • What's what in Fotoware
    • GDPR
    • Fotoware Veloz releases
    • Activity Exports
    • Example workflows
  3. Fotostation
    • Getting started with Fotostation
    • Viewing, selecting and sorting files
    • Managing your assets with archives
    • Adding metadata to assets
    • Searching for assets
    • Working with your assets
    • Version Control in Fotostation
    • Automating tasks with Actions
    • Configuring metadata fields and editors
    • Configuring Fotostation
    • Configuring Fotostation for multi-user environments
    • Troubleshooting Fotostation
  4. Fotoware Flow
    • What is Flow?
    • Getting started
    • Flow dictionary
  5. Fotoware On-Premises
    • Getting started
    • Index Manager
    • FotoWeb
    • Color Factory
    • Connect
    • Operations Center Guide
  6. Integrations and APIs (Fotoware Veloz & On-Premises)
    • The Fotoware API
    • Creating integrations using embeddable widgets
    • Authorizing applications using OAuth
    • Auto-tagging
    • FotoWeb Drag and Drop export
    • Integration using webhooks
    • Optimizely and Episerver plugin documentation
    • User Interface Integrations
  7. Fotoware Mobile
    • User guide for Fotoware Mobile for iPhone and Android
    • User guide to FotoWeb for iPad (Legacy)
    • User guide to FotoWeb for iPhone and Android (Legacy)

Contact Us

If you still have questions or prefer to get help directly from an agent, please submit a request.
We’ll get back to you as soon as possible.

Please fill out the contact form below and we will reply as soon as possible.

Support

Table of Contents

Registering a user interface integration General settings HTTP/HTTPS remarks Filters Archive filter
  • Home
  • Integrations and APIs (Fotoware Veloz & On-Premises)
  • User Interface Integrations

Registering a User Interface Integration in Fotoware

17. June 2025

Elaine Foley

Table of Contents

Registering a user interface integration General settings HTTP/HTTPS remarks Filters Archive filter

Registering a user interface integration

To register an integration, the logged-in user must be a member of a group that has the Manage users and security permission.

  1. From the Tools menu (cogwheel icon), go to Site Configuration > Integrations > Add application.
  2. Select Add application to create a new integration.
  3. Select Web App/API from the Type drop-down list.
  4. API vs Selection Widget: If an application is registered with the Selection Widget scope, it cannot use the API. This implies that a user interface integration will not be able to obtain an OAuth access token ({{oauth.token}}  So, while a user interface integration can be made as a Selection Widget type, it cannot use the Fotoware API.
    Note: Whether your Fotoware has an API license depends on your site's licensing scheme/SaaS plan.
  5. Enter a name for the application in the Name field.
  6. To define redirect URIs, select Add and enter the URI address. If you enable CORS later, any URIs specified here are automatically added.
  7. Select Create in the User Interface Integrations section, where you can add embedded UIs for the Quick Info, Asset Details, and Preview areas in Fotoware. Select Create to set up the integration.

General settings

  1. On the General tab, enter the Title and URL for your integration. The URL can contain query parameters to search for (for example, the asset ID in the connected system).
  2. Select the Type that determines the area on the details page to which the integration is added. You can choose between Quick Info, Asset Details, and Preview. For more information about these options, see User interface integrations.
  3. Select Save.

HTTP/HTTPS remarks

If the Fotoware site is hosted on a HTTPS address, the user interface integration should also be hosted on a HTTPS address. Otherwise, it will likely be blocked by the browser. HTTPS is generally recommended for security reasons.
As an exception to this rule, loopback URLs (using localhost, 127.0.0.1, or [::1] as the host name) can and should always use HTTP.

Filters

On the Filters tab, you can manage the file types that trigger the integration. This way, you can make the integration appear only when users preview certain types of assets.

Select Any, Image, Video, Graphic, Audio, Document, or Other from the File Type drop-down list.

To display the integration only for files with a specific extension, choose Any file type and add the extension below. Multiple extensions can be separated using a comma and a space, as such: .ext, .ex2, .ex3.

You can also define additional conditions in a metadata field that must be met to display the integration. Select a metadata field and the match type, and enter the expression that must be matched. You can also use regular expressions.

Archive filter

On the Archives tab, you can define the archives where the integration should be used. It is enabled in all archives by default, but you can include or exclude archives to suit your requirements.

ui integration user registration

Was this article helpful?

Yes
No
Give feedback about this article

Related Articles

  • Working with the Fotoware Extension for Illustrator
  • Application registration using OAuth 2.0
  • Get started with OAuth
  • User Interface Integrations - an overview
eco-lighthouse-miljøfyrtårn

Company

  • About us
  • Resellers
  • Careers
  • Contact us

Help & support

  • Support center
  • Consultancy
  • Tech partners
  • Fotostation
  • System status

Trust Center

  • Legal
  • Security
  • Sustainability & ESG

Locations

Fotoware AS (HQ)
Tollbugata 35
0157 OSLO
Norway
FotoWare Switzerland AG
Industriestrasse 25
5033 Buchs (AG)
Switzerland

Copyright 2025 Fotoware All rights reserved.

  • Terms of service
  • Privacy policy
  • Cookie policy

Knowledge Base Software powered by Helpjuice

Expand