Skip to content
VynCo is in public beta — we'd love your feedback.

Embeddable Widget

Embed live VynCo company summary cards on any website. Choose between a lightweight JavaScript loader or a direct iframe — both options support theming and field selection.

Overview

The VynCo embeddable widget renders a compact company summary card showing key registry data such as company name, canton, share capital, and status. Widgets are publicly accessible — no API key or authentication is required. This makes them ideal for partner websites, compliance portals, and directory listings.

Script Tag

Add one script tag and use data-vynco-uid attributes on any element. The loader scans the page and renders widgets automatically.

Direct Iframe

Embed a standalone iframe with full control over dimensions, theme, and field selection via URL parameters.

Script Tag Integration

The simplest way to embed VynCo widgets. Add the embed script to your page and place data-vynco-uid attributes on any HTML elements where you want a company card to appear.

Basic Example

html
<!-- Load the VynCo widget loader (once per page) -->
<script src="https://vynco.ch/api/v1/widget/embed.js"></script>
<!-- Place company cards anywhere on the page -->
<div data-vynco-uid="CHE-105.962.875"></div>
<div data-vynco-uid="CHE-109.322.551"></div>

With Options

html
<!-- Dark theme with specific fields -->
<div data-vynco-uid="CHE-105.962.875"
     data-vynco-theme="dark"
     data-vynco-fields="name,canton,capital,status,industry"></div>

The script is lightweight (<5 KB gzipped) and loads asynchronously. It scans the DOM on load and observes for dynamically added elements via MutationObserver.

Direct Iframe

For maximum isolation and control, embed company cards directly using an iframe. All customisation is done via URL query parameters.

Iframe Example

html
<iframe
  src="https://vynco.ch/api/v1/widget/company/CHE-105.962.875?theme=light&fields=name,canton,capital,status"
  width="400"
  height="200"
  frameborder="0"
  title="VynCo Company Widget"
></iframe>

URL Parameters

ParameterDefaultDescription
themelight"light" or "dark"
fieldsname,canton,capital,statusComma-separated list of fields to display

Customisation

Control which data fields are displayed in the widget using the fields parameter. Available fields:

namecantoncapitalstatuslegalFormindustryauditorfoundedboardSize

Themes

Widgets support light and dark themes. The theme controls the background colour, text colour, and border styling of the rendered card to match your website design.

Security & CORS

Widget endpoints are public and do not require authentication. CORS headers are set to allow embedding from any origin. The widget script and iframe content are served with appropriate Content Security Policy headers. No cookies or tracking are used.