Adding multi-language structured webcontents through headless API Adding multi-language structured webcontents through headless API https://liferay.dev/c/message_boards/find_thread?p_l_id=119785294&threadId=120422270 2026-04-04T03:14:06Z 2026-04-04T03:14:06Z RE: Adding multi-language structured webcontents through headless API Fernando Fernandez https://liferay.dev/c/message_boards/find_message?p_l_id=119785294&messageId=120427361 2020-11-12T11:31:01Z 2020-11-12T11:31:01Z <html><head></head><body><p>Thanks Javier, that did it! :-)</p> <p>I think I'm still sending too much data but this POST works:</p> <pre><code class="language-javascript">{ "contentStructureId": 38734, "siteId": 20124, "title": "Investimento de 900 mil euros", "title_i18n": { "pt-PT": "Investimento de 900 mil euros", "en-US": "Investimento de 900 mil euros" }, "description": "Enim sapiente integer exercitation beatae ab platea eos.", "description_i18n": { "pt-PT": "Enim sapiente integer exercitation beatae ab platea eos.", "en-US": "Enim sapiente integer exercitation beatae ab platea eos." }, "contentFields": [ { "dataType": "string", "inputControl": "textarea", "label": "PageContent", "label_i18n": { "en-US": "PageContent" }, "name": "PageContent", "nestedContentFields": [], "repeatable": false, "value": { "data": "Com o intuito de promover a manutenção, cerca de 900 mil euros." }, "value_i18n": { "pt-PT": { "data": "Com o intuito de promover a manutenção, cerca de 900 mil euros." }, "en-US": { "data": "Com o intuito de promover a manutenção, cerca de 900 mil euros." } } }, { "dataType": "image", "label": "PageImage", "label_i18n": { "en-US": "PageImage" }, "name": "PageImage", "nestedContentFields": [], "repeatable": false, "value": { "image": { "contentType": "Document", "contentUrl": "/documents/20124/38878/cm187383b.jpg/a94237dd-7e2b-a555-bae2-a76a386ab289?t=1605130977583", "description": "", "encodingFormat": "image/jpeg", "fileExtension": "jpg", "id": 39158, "sizeInBytes": 8411159, "title": "cm187383b.jpg" } }, "value_i18n": { "pt-PT": { "image": { "contentType": "Document", "contentUrl": "/documents/20124/38878/cm187383b.jpg/a94237dd-7e2b-a555-bae2-a76a386ab289?t=1605130977583", "description": "", "encodingFormat": "image/jpeg", "fileExtension": "jpg", "id": 39158, "sizeInBytes": 8411159, "title": "cm187383b.jpg" } }, "en-US": { "image": { "contentType": "Document", "contentUrl": "/documents/20124/38878/cm187383b.jpg/a94237dd-7e2b-a555-bae2-a76a386ab289?t=1605130977583", "description": "", "encodingFormat": "image/jpeg", "fileExtension": "jpg", "id": 39158, "sizeInBytes": 8411159, "title": "cm187383b.jpg" } } } } ], "taxonomyCategoryIds":[38762] }</code></pre> <p>&nbsp;</p></body></html> Fernando Fernandez 2020-11-12T11:31:01Z RE: RE: Adding multi-language structured webcontents through headless API Javier De Arcos https://liferay.dev/c/message_boards/find_message?p_l_id=119785294&messageId=120426880 2020-11-12T09:30:44Z 2020-11-12T09:30:44Z <html><head></head><body><p>To provide the Taxonomy Categories you should add them as an array of their ids. If you take a look to the StructuredContent schema you will find it in the property taxonomyCategoryIds</p> <pre><code>StructuredContent: description: Represents content that has fields and is rendered by a template backed by a `ContentStructure`. This is modeled internally as a `JournalArticle`. properties: ... taxonomyCategoryIds: description: A write-only field to add a category to this structured content. items: format: int64 type: integer type: array writeOnly: true ... </code></pre> <p>So you have to add them in your request like</p> <pre><code class="language-javascript">"taxonomyCategoryIds":[38762]</code></pre> <p>In the case of the images, I guess the problem is you are not providing any value to the default language in the "value" property, like you are doing with the text area field. You should provide the english value in the "value" property and any other value in the "value_i18n" property. Try this and let me know</p></body></html> Javier De Arcos 2020-11-12T09:30:44Z RE: RE: Adding multi-language structured webcontents through headless API Fernando Fernandez https://liferay.dev/c/message_boards/find_message?p_l_id=119785294&messageId=120426251 2020-11-12T00:24:56Z 2020-11-12T00:24:56Z <html><head></head><body><p>Hi Luis Miguel,</p> <p>WIth your help and a suggestion I also got from Javier Arcos on slack I managed to POST a multi-language web content. I'm currently trying to add an image and some categories but I'm getting nowhere.&nbsp;</p> <p>I have a structure in place and I follow the JSON I get from a content inputed by hand, but it seems the images and categories are just being ignored, althoug the web content is being stored.</p> <p>I'm POSTing to&nbsp;http://localhost:8080/o/headless-delivery/v1.0/sites/20124/structured-contents/ with a request body like:</p> <pre><code class="language-javascript">{ "contentStructureId": 38734, "dateCreated": "2020-11-01T06:00:00Z", "dateModified": "2020-11-01T06:00:00Z", "datePublished": "2020-11-01T06:00:00Z", "siteId": 20124, "title": "Investimento de 900 mil euros", "title_i18n": { "pt-PT": "Investimento de 900 mil euros", "en-US": "Investimento de 900 mil euros" }, "description": "Enim sapiente integer exercitation beatae ab platea eos.", "description_i18n": { "pt-PT": "Enim sapiente integer exercitation beatae ab platea eos.", "en-US": "Enim sapiente integer exercitation beatae ab platea eos." }, "contentFields": [ { "dataType": "string", "inputControl": "textarea", "label": "PageContent", "label_i18n": { "en-US": "PageContent" }, "name": "PageContent", "nestedContentFields": [], "repeatable": false, "value": { "data": "Com o intuito de promover a manutenção, cerca de 900 mil euros." }, "value_i18n": { "pt-PT": { "data": "Com o intuito de promover a manutenção, cerca de 900 mil euros." }, "en-US": { "data": "Com o intuito de promover a manutenção, cerca de 900 mil euros." } } }, { "dataType": "image", "label": "PageImage", "label_i18n": { "en-US": "PageImage" }, "name": "PageImage", "nestedContentFields": [], "repeatable": false, "value": {}, "value_i18n": { "pt-PT": { "image": { "contentType": "Document", "contentUrl": "/documents/20124/38878/cm187383b.jpg/a94237dd-7e2b-a555-bae2-a76a386ab289?t=1605130977583", "description": "", "encodingFormat": "image/jpeg", "fileExtension": "jpg", "id": 39158, "sizeInBytes": 8411159, "title": "cm187383b.jpg" } }, "en-US": { "image": { "contentType": "Document", "contentUrl": "/documents/20124/38878/cm187383b.jpg/a94237dd-7e2b-a555-bae2-a76a386ab289?t=1605130977583", "description": "", "encodingFormat": "image/jpeg", "fileExtension": "jpg", "id": 39158, "sizeInBytes": 8411159, "title": "cm187383b.jpg" } } } } ], "taxonomyCategories": [ { "taxonomyCategoryId": 38762, "taxonomyCategoryName": "Urbanismo", "taxonomyCategoryName_i18n": { "pt-PT": "Urbanismo", "en-US": "Urbanismo" } } ] }</code></pre> <p>&nbsp;&nbsp;The response I get from the server doesn't include neither the images nor the categories:</p> <pre><code class="language-javascript">{ "actions": { "subscribe": { "method": "PUT", "href": "http://localhost:8080/o/headless-delivery/v1.0/structured-content/{structuredContentId}/subscribe" }, "unsubscribe": { "method": "PUT", "href": "http://localhost:8080/o/headless-delivery/v1.0/structured-content/{structuredContentId}/unsubscribe" }, "get": { "method": "GET", "href": "http://localhost:8080/o/headless-delivery/v1.0/structured-contents/{structuredContentId}" }, "replace": { "method": "PUT", "href": "http://localhost:8080/o/headless-delivery/v1.0/structured-contents/{structuredContentId}" }, "update": { "method": "PATCH", "href": "http://localhost:8080/o/headless-delivery/v1.0/structured-contents/{structuredContentId}" }, "get-template": { "method": "GET", "href": "http://localhost:8080/o/headless-delivery/v1.0/structured-contents/{structuredContentId}/rendered-content/{templateId}" }, "delete": { "method": "DELETE", "href": "http://localhost:8080/o/headless-delivery/v1.0/structured-contents/{structuredContentId}" } }, "availableLanguages": [ "en-US", "pt-PT" ], "contentFields": [ { "dataType": "string", "inputControl": "textarea", "label": "PageContent", "name": "PageContent", "nestedContentFields": [], "repeatable": false, "value": { "data": "Com o intuito de promover a manutenção, cerca de 900 mil euros." } }, { "dataType": "image", "label": "PageImage", "name": "PageImage", "nestedContentFields": [], "repeatable": false, "value": {} } ], "contentStructureId": 38734, "creator": { "additionalName": "", "contentType": "UserAccount", "familyName": "Test", "givenName": "Test", "id": 20130, "name": "Test Test", "profileURL": "/web/test" }, "customFields": [], "dateCreated": "2020-11-12T00:14:49Z", "dateModified": "2020-11-12T00:14:49Z", "datePublished": "2020-11-01T06:00:00Z", "description": "Enim sapiente integer exercitation beatae ab platea eos.", "friendlyUrlPath": "investimento-de-900-mil-euros", "id": 39285, "key": "39283", "keywords": [], "numberOfComments": 0, "relatedContents": [], "renderedContents": [ { "renderedContentURL": "http://localhost:8080/o/headless-delivery/v1.0/structured-contents/39285/rendered-content/39249", "templateName": "NewsStory basic template" } ], "siteId": 20124, "subscribed": false, "taxonomyCategories": [], "title": "Investimento de 900 mil euros", "uuid": "e85f7271-c645-690c-35a7-00de30dff8af" }</code></pre> <p>Any ideas?</p> <p>I'm using DXP 7.2 SP2.&nbsp;</p> <p>TIA</p> <p>Fernando</p></body></html> Fernando Fernandez 2020-11-12T00:24:56Z RE: Adding multi-language structured webcontents through headless API Luis Miguel Barcos https://liferay.dev/c/message_boards/find_message?p_l_id=119785294&messageId=120425489 2020-11-11T10:46:18Z 2020-11-11T10:46:18Z <html><head></head><body><p>Hello Fernando,</p> <p>To add multilingual fields it is necessary to use the <em>i18n</em> <em>properties</em>. For example, if you have a localized title you should use <em>title</em> with the default language (or the one using in the accept-language header) and the rest you add it in the <em>title_i18n</em> like</p> <pre><code class="language-html">{ ... "title": "The notebook" "title_i18n": { "es_ES": "El diario", "fr_FR": "Le notebook" }, ... }</code></pre> <p>If the multilingual content is inside a contentField you should use the data_i18n or similiar properties to add the localized values.</p> <p>Hope this helps you and kudos to Javier de Arcos for the response.</p> <p>Luismi</p></body></html> Luis Miguel Barcos 2020-11-11T10:46:18Z Adding multi-language structured webcontents through headless API Fernando Fernandez https://liferay.dev/c/message_boards/find_message?p_l_id=119785294&messageId=120422269 2020-11-09T21:50:20Z 2020-11-09T21:50:20Z <html><head></head><body><p>Hi guys,</p> <p>On 7.2 I'm trying to add structured content with headless api. I created a structure "Client" with two text fields (Name and Surname).</p> <p>I'm already able to insert new webcontents with:</p> <pre><code>POST&amp;nbsp; http://localhost:8080/o/headless-delivery/v1.0/sites/20124/structured-contents/</code></pre> <p>Where the request body is:</p> <pre><code class="language-javascript">{ "title": "Mary Shelley", "contentStructureId": 38610, "contentFields": [ { "name": "Name", "value": { "data": "Mary" } }, { "name": "Surname", "value": { "data": "Shelley" } } ] }</code></pre> <p>&nbsp;</p> <p>Now I need to add multi-lingual content but I'm at a loss on how to do it, even if it seems to be <a href="https://app.swaggerhub.com/apis/liferayinc/headless-delivery/v1.0#/StructuredContent/postSiteStructuredContent" target="_blank">supported by the API</a>.</p> <p>I've tried some variants like:</p> <pre><code class="language-javascript">{ "title": "Joanne d'Arc", "contentStructureId": 38610, "contentFields": [ { "name": "Name", "value": { "data": "Joanne" }, "name": "Name_pt_PT", "value": { "data": "Joana" } }, { "name": "Surname", "value": { "data": "d'Arc" }, "name": "Surname_pt_PT", "value": { "data": "de Arc" } } ] }</code></pre> <p>but the result is "<strong>Unable&nbsp;to&nbsp;get&nbsp;content&nbsp;field&nbsp;value&nbsp;for&nbsp;\"Name_pt_PT\"&nbsp;for&nbsp;content&nbsp;structure&nbsp;38610</strong>".</p> <p>Anybody out there has a cheat sheet for this? I couldn't find many examples...</p> <p>TIA</p> <p>Fernando</p></body></html> Fernando Fernandez 2020-11-09T21:50:20Z