Understanding FID in Cincopa
What is FID?
In Cincopa, FID stands for Fully-Qualified ID. It is a core identifier used by both the frontend embed code API and the backend API to load and present content in a consistent, contextualized way.
FID determines both what content is displayed (assets) and how it is presented (gallery layout, player, design, and customization).
Object Types in Cincopa
Cincopa works with two primary object types:
- Gallery: An ordered list of assets combined with a visual presentation. The presentation is based on a selected template and includes customization settings.
- Asset: An individual media file such as a video, image, audio clip, or document. Assets can appear in multiple galleries.
Types of Galleries
Cincopa supports multiple gallery types to support flexible visual configuration and reusability:
- Basic Gallery: Derives its visual from a built-in Cincopa template. Customizations are stored directly in the gallery.
- Master Gallery: Also uses a built-in Cincopa template. Designed to serve as a visual template for other galleries. When updated, all linked galleries that inherit from it are immediately updated visually.
- Linked Gallery: Inherits its visual configuration (template + customization) from a designated Master Gallery. Maintains its own separate list of assets. Cannot override visual settings independently.
FID Formats
FID formats define how galleries and assets are referenced when working with the Cincopa API, both on the frontend (embed code API) and the backend (REST or server-side API). They allow you to control the visual layout and the content separately, enabling flexible rendering and reuse patterns that go beyond the static Master/Linked gallery model.
1. Gallery FID
Format: {gallery_id}
Behavior: Loads the full gallery — both its visual configuration and its asset list.
Use Case: Embedding a complete gallery with its default styling and content.
2. Visual Gallery FID + Asset ID
Format: {visual_gallery_id}!{asset_id}
Behavior: Uses the visual layout and template from the gallery (visual_gallery_id) and dynamically injects a specific asset (asset_id). The asset does not need to be part of the gallery’s asset list.
Use Case: Embedding a single video or audio using the design of an existing gallery, without modifying that gallery’s content.
3. Visual Gallery FID + Content Gallery FID
Format: {visual_gallery_id}@{content_gallery_id}
Behavior: Uses the visual configuration from the left-hand gallery and the asset list from the right-hand gallery.
Use Case: Reusing a gallery design across different content sets without duplicating or modifying the original gallery.
Summary of FID Formats
| Format | Visual From | Content From | Description |
|---|---|---|---|
| {gallery_id} | gallery_id | gallery_id | Full gallery usage |
| {visual_gallery_id}!{asset_id} | visual_gallery_id | asset_id | Single asset with reused gallery visual |
| {visual_gallery_id}@{content_gallery_id} | visual_gallery_id | content_gallery_id | Reuse visual layout with different content set |
Cincopa FID Usage Examples
Example 1: Regular Gallery Using Basic FID Format
Gallery ID: AUFAqA4w45xR
Gallery Type: Regular Gallery
Template Used: “Online Video Course”
Content: 5 videos covering an online SQL course
FID Format Used: {gallery\_id}
✅ Standard Embed Code:
<div id="cincopa_AUFAqA4w45xR" class="gallerydemo cincopa-fadein">
<div style='width: 100%; height: auto; max-width: 100%; display:flex;'>
<img src="https://rtcdn.cincopa.com/thumb.aspx?fid=AUFAqA4w45xR&size=large"
style="filter:blur(5px); object-fit:contain; width:100%; padding: 0; margin: 0; aspect-ratio: 1.78;" />
</div>
</div>
<script src="//rtcdn.cincopa.com/meta_json.aspx?fid=AUFAqA4w45xR&ver=v2&id=cincopa_AUFAqA4w45xR" type="text/javascript"></script>
<script src="//rtcdn.cincopa.com/libasync.js" type="text/javascript"></script>
🧑💻 Developer-Friendly Embed Code:
<div id="cincopa_216287034" class="gallerydemo cincopa-fadein">
<div style='width: 100%; height: auto; max-width: 100%; display:flex;'>
<img src="https://rtcdn.cincopa.com/thumb.aspx?fid=AUFAqA4w45xR&size=large"
style="filter:blur(5px); object-fit:contain; width:100%; aspect-ratio: 1.78;" />
</div>
</div>
<script type="text/javascript">
var cpo = [];
cpo["_object"] = "cincopa_216287034";
cpo["_fid"] = "AUFAqA4w45xR";
var _cpmp = _cpmp || []; _cpmp.push(cpo);
(function() {
var cp = document.createElement("script");
cp.type = "text/javascript"; cp.async = true;
cp.src = "https://rtcdn.cincopa.com/libasync.js";
var c = document.getElementsByTagName("script")[0];
c.parentNode.insertBefore(cp, c);
})();
</script>
Example 2: Visual Gallery FID + Asset ID
Visual Gallery ID: AgLAvQvxyiqd
Gallery Type: Regular Gallery
Template Used: Single Video Player
Customization: Green-themed player, watermark, lead generation form
Asset ID: AcCDbRO7HltO (First video of SQL course)
FID Format Used: {visual_gallery_id}!{asset_id}
✅ Standard Embed Code:
<div id="cincopa_AgLAvQvxyiqdAcCDbRO7HltO" class="gallerydemo cincopa-fadein">
<div style='width: 100%; height: auto; max-width: 100%; display:flex;'>
<img src="https://rtcdn.cincopa.com/thumb.aspx?fid=AgLAvQvxyiqd!AcCDbRO7HltO&size=large"
style="filter:blur(5px); object-fit:contain; width:100%; padding: 0; margin: 0; aspect-ratio: 1.78;" />
</div>
</div>
<script src="//rtcdn.cincopa.com/meta_json.aspx?fid=AgLAvQvxyiqd!AcCDbRO7HltO&ver=v2&id=cincopa_AgLAvQvxyiqdAcCDbRO7HltO" type="text/javascript"></script>
<script src="//rtcdn.cincopa.com/libasync.js" type="text/javascript"></script>
🧑💻 Developer-Friendly Embed Code:
<div id="cincopa\_216287035" class="gallerydemo cincopa-fadein">
<div style='width: 100%; height: auto; max-width: 100%; display:flex;'>
<img src="https://rtcdn.cincopa.com/thumb.aspx?fid=AgLAvQvxyiqd\!AcCDbRO7HltO\&size=large"
style="filter:blur(5px); object-fit:contain; width:100%; aspect-ratio: 1.78;" />
</div>
</div>
<script type="text/javascript">
var cpo = [];
cpo["_object"] = "cincopa_216287035";
cpo["_fid"] = "AgLAvQvxyiqd!AcCDbRO7HltO";
var _cpmp = _cpmp || []; _cpmp.push(cpo);
(function() {
var cp = document.createElement("script");
cp.type = "text/javascript"; cp.async = true;
cp.src = "https://rtcdn.cincopa.com/libasync.js";
var c = document.getElementsByTagName("script")[0];
c.parentNode.insertBefore(cp, c);
})();
</script>Example 3: Visual Gallery FID + Content Gallery FID
Visual Gallery ID: AgLAvQvxyiqd
Content Gallery ID: AUFAqA4w45xR
Template Used: Single Video Player
Customization: Green-themed player, watermark, lead generation form
Content: 5 videos of an online SQL course
FID Format Used: {visual_gallery_id}@{content_gallery_id}
✅ Standard Embed Code:
<div id="cincopa_AgLAvQvxyiqdAUFAqA4w45xR" class="gallerydemo cincopa-fadein">
<div style='width: 100%; height: auto; max-width: 100%; display:flex;'>
<img src="https://rtcdn.cincopa.com/thumb.aspx?fid=AgLAvQvxyiqd@AUFAqA4w45xR&size=large"
style="filter:blur(5px); object-fit:contain; width:100%; padding: 0; margin: 0; aspect-ratio: 1.78;" />
</div>
</div>
<script src="//rtcdn.cincopa.com/meta_json.aspx?fid=AgLAvQvxyiqd@AUFAqA4w45xR&ver=v2&id=cincopa_AgLAvQvxyiqdAUFAqA4w45xR" type="text/javascript"></script>
<script src="//rtcdn.cincopa.com/libasync.js" type="text/javascript"></script>
🧑💻 Developer-Friendly Embed Code:
<div id="cincopa_216287036" class="gallerydemo cincopa-fadein">
<div style='width: 100%; height: auto; max-width: 100%; display:flex;'>
<img src="https://rtcdn.cincopa.com/thumb.aspx?fid=AgLAvQvxyiqd@AUFAqA4w45xR&size=large"
style="filter:blur(5px); object-fit:contain; width:100%; aspect-ratio: 1.78;" />
</div>
</div>
<script type="text/javascript">
var cpo = [];
cpo["_object"] = "cincopa_216287036";
cpo["_fid"] = "AgLAvQvxyiqd@AUFAqA4w45xR";
var _cpmp = _cpmp || []; _cpmp.push(cpo);
(function() {
var cp = document.createElement("script");
cp.type = "text/javascript"; cp.async = true;
cp.src = "https://rtcdn.cincopa.com/libasync.js";
var c = document.getElementsByTagName("script")[0];
c.parentNode.insertBefore(cp, c);
})();
</script>