Embed Entries or Assets

Contentstack allows you to embed entries and assets directly within the JSON Rich Text Editor field. These embedded items are dynamically updated whenever the source entry or asset is modified, ensuring your content stays in sync.

The JSON RTE field lets you embed entries inline within the flow of text, as a separate content block, or as a dynamic hyperlink.

Note: The embed feature is only available in the Advanced and Custom Rich Text Editor fields. Basic RTE does not support this option.

When you embed entries or assets in the JSON RTE, the data of the embedded items is stored directly, not just a reference. As a result:

• Updates to the original entries or assets are not reflected automatically in the RTE content.
• The RTE field will continue to display the original embedded data.

However, the latest versions of these embedded items can be accessed through the _embedded_items section.

Note: The RTE field does not auto-replace old data with the updated versions from _embedded_items. It is the user's responsibility to update the content as needed.

By embedding entries, you can dynamically insert structured content such as product listings, event details, or blog excerpts.

In the Custom editor type, enable the Embed Objects option and select the content type from which you want to embed entries.

Here are some examples of how embedded entries can enhance content:

1. Inline Entries: Embed dynamic values like working titles or links triggering modal pop-ups.
2. Block Entries: Add rich elements like image carousels, product lists, or surveys as content blocks.
3. Hyperlinks: Create links that reflect changes in the linked entries automatically.

Note: When embedding localized entries, updates to localized versions must be applied manually. For example, if a "Blog" entry is linked within the "Home" entry in English and later localized to Arabic, you will need to manually update the Arabic "Home" entry to link to the Arabic version of the "Blog."

To embed an entry within your JSON RTE, log in to your Contentstack account and follow the steps below:

1. Navigate to the desired stack and click the Entries icon in the left navigation panel.
2. Create a new entry or open an existing one containing a JSON RTE field.
3. In the JSON RTE field, click the Embed Entry icon in the toolbar.
4. In the Select Entry modal, choose the content type from which to embed an entry.
5. Select the desired entry from the list.
6. Choose the Embed Type:
   • Block Embed: Embeds the entry as a standalone block.
   • Inline Embed: Embeds the entry within a text flow.
7. Click Embed Selected Entry to finalize.

Note: You can embed up to 100 entries in a single RTE field.

Embedding assets enriches your content with media that updates automatically when changed in the Asset Manager, ensuring consistency.

Assets can be embedded by default into the JSON RTE field. In the Custom editor type, select the Asset option.

Here are some examples of how embedded assets can enhance content:

1. Displayable Component: Images or media are automatically updated on the frontend when modified in the Asset Manager.
2. Downloadable Files: Provide links to PDFs or other reference files for download.

To embed an asset within your JSON RTE, log in to your Contentstack account and follow these steps:

1. Navigate to the desired stack and click the Entries icon in the left navigation panel.
2. Create a new entry or open an existing one with a JSON RTE field.
3. In the JSON RTE field, click the Asset icon in the toolbar.
4. From the dropdown, select Choose from assets or Upload new asset(s).
5. Choose from Assets:
   • In the Select Asset modal, browse or search for the asset.
   • Select the desired asset to embed.
6. Upload New Asset(s):
   • In the Upload Asset modal, click “+” to create a folder if needed.
   • Select files from your system (supported formats: images, PDFs, videos).
7. Choose the Embed Type:
   • Block Embed: Embeds the asset as a block.
   • Inline Embed: Embeds the asset within a sentence or paragraph.
8. Click Add Selected Asset to finalize.

Note: If an asset is deleted from the library, any embedded instance in the JSON output becomes invalid.

You can edit an embedded asset directly within the JSON RTE:

1. Hover over the embedded asset and click the Edit icon.
2. Use the Edit Image modal to configure:
   • Alt Text: For accessibility and SEO.
   • Alignment: Left, center, or right.
   • Caption: Text below the asset.
   • Embed Link: Link the asset to a URL.
   • Auto adjust dimensions: Auto-resize to fit editor width.
   • Lock aspect ratio: Maintain proportions during resizing.
   • Open link in a new tab: Enable if needed.
   • Inline image: Embed within flowing text.
3. Click Save.

Note: These edits affect only the current embed instance and do not modify the original asset in the Asset Manager.

Embedding entries and assets within the JSON RTE enriches your content with dynamic and structured elements. By following this guide, you can seamlessly integrate entries and assets—whether as inline components, blocks, or hyperlinks.