# How to change social media preview (Open Graph metadata) via API Copy for LLM[View as Markdown]() Using the **[Short.io API](https://developers.short.io/)** features you can change the generated preview data of a link that you share on social networks. Note The Social media preview is available starting from the **Pro plan**. Before you begin, make sure \[you have created an API key]\(/articles/api-reference/Technical questions/how-to-use-the-short.io-api#how-to-create-an-api-key). ## To update social media preview[​](#to-update-social-media-preview "Direct link to To update social media preview") 1. Sign in to your [Short.io account](https://short.io/). 2. Browse the [opengraph properties](https://developers.short.io/reference/put_links-opengraph-domainid-linkid) page. 3. In the **Path params** section provide the needed data: * **domainId -** the unique identifier of your domain * **linkId** - the unique identifier of your short link Note You can find information on how to retrieve the above parameters in the following \[article]\(/articles/api-reference/Technical questions/how-to-retrieve-domain-link-and-folder-identifiers-from-the-short.io-urls-and-api). ![API reference path params with domainId and linkId fields highlighted](/assets/images/api-and-technical-questions-how-to-change-social-media-preview-open-graph-metadata-via-api-screenshotfrom2024-11-2910-24-32-e8799723-18aa0de3d4b5cd87b730a9d9a9c39147.png) 4. Navigate to the **Body params** section and click on **+** to **Add** **array of strings**: ![Body Params section with Add array of strings field and plus button](data:image/png;base64,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L2PKms/4NmcFH0/5A+ddfSbhdctYdsiG2Bbc8uTddEs8PPgoW/77GA9OyGDfshVsGlAPd2FJOHN5PHgAT9M/8MfOB1hUUJ9+nZIxsfF4YjCAaFERQdsme/E4XvhoCxHAdLkgGi2JuIaf1uc14qetvhMREZHKVvFwFpNIamoy2zJyKDiUTaHhwuOrSr2zzqL9xT3p37leaTAwSGx5FSMfb8SECfNYtGEX+/JCuOJTqNekJd1796JH48QjU5pxVauREl/AwUCY4uKSPuvUPpMW7S7k8m4tqRP3a/12l03m8mWsD4JRtQWdmnnL/NV7Tls6VF3E9JzdLFiyl37dT+zBPKMz112cxj9nZLJ79jSW9LoeY1FJJS62eTvaJRw7dhcNOpxH7UlT2J25mvkb+3BBYUnVMaY0gGGeQc8776XnMVt5vKVr2YqLKQLctVvQtWWIddszyCoIg9dPzdoNOf+SKxjYqapuBSEiIvIbYdi2/aNr8EVERETkf0MFFREREREHUTgTERERcRCFMxEREREHUTgTERERcRCFMxEREREHUTgTERERcRCFMxEREREHUTgTERERcRCFMxEREREHUTgTERERcRCFMxEREREHUTgTERERcRCFMxEREREHUTgTERERcRCFMxEREREHUTgTERERcRCFMxEREREHUTgTERERcRD3r9GpZVkEAgGKiooIBoNEIpFfYzciIiIilcLtduP1eomLiyM+Ph7TPHX1LsO2bftUdWbbNgUFBeTl5eFyufB6vXg8HtzuXyUDioiIiFSKSCRCKBQiGAwSjUZJTEzE7/djGEaF+z5l4cyyLLKzswmFQvj9frxe76noVkRERMTRgsEgBQUFeDwekpOTK1xFOyXhzLZtsrOziUQiJCYmntLSnoiIiIjTWZZFXl4ebreb5OTkClXQTkmKKigoIBgMKpiJiIjIack0TRITE49U0SrUV0UHczgp+v1+BTMRERE5bZmmid/vJy8vD8uyfnk/FR1IIBA4svhfRERE5HTm9XpxuVwEAoFf3EeFw1lRUZGCmYiIiEgpr9dLUVHRL96+wuEsGAzi8Xgq2o2IiIjI74LH4yEYDP7i7SscziKRiH7HTERERKSU2+2u0A/wawW/iIiIiIMonImIiIg4iMKZiIiIiIMonImIiIg4iMKZiIiIiIMonImIiIg4iMKZiIiIiIMonImI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) 5. Enter as much parameters and their values as needed, *for example*: * \[ "**description**", "This is my online store" ] * \[ "**image**", "``" ] * \[ "**twitter:card**", "summary" ] ![Body params with Open Graph description, image, and twitter values](/assets/images/api-and-technical-questions-how-to-change-social-media-preview-open-graph-metadata-via-api-screenshotfrom2024-09-3012-18-33-c6d18ed7-531a60ce1c0265a3095f0d00dac2aecd.png) Note You can review the full list of parameters [here](#full-list-of-parameters-descriptions-and-expected-values). 6. Navigate to the **Credentials** section and enter your authorization key: ![Credentials section with API key header and Try It button highlighted](/assets/images/api-and-technical-questions-how-to-change-social-media-preview-open-graph-metadata-via-api-screenshotfrom2024-11-2910-32-08-95f2f86e-a2b1ebaf6ef9443ad050b89a1335af4a.png) 7. Click on **Try it!**. 8. In the **Response** panel you can review the result: ![API response showing 200 status with Open Graph metadata arrays](/assets/images/api-and-technical-questions-how-to-change-social-media-preview-open-graph-metadata-via-api-screenshotfrom2024-09-3012-20-46a-f309689a-2c54da97d4a4b312d5bbff206f30e678.png) 9. Sign in to your [Short.io account](https://short.io/). 10. From the **Branded links** menu click on to edit the short link which you updated via the API: ![Branded links list with edit pencil icon highlighted on a link](/assets/images/api-and-technical-questions-how-to-change-social-media-preview-open-graph-metadata-via-api-image-6b30ef68-5dbb083de0667031e94665739bb596b1.png) 11. Navigate to the **Social media** menu to review the new values: ![Social media metadata editor with Open Graph fields populated](/assets/images/api-and-technical-questions-how-to-change-social-media-preview-open-graph-metadata-via-api-screenshotfrom2024-11-2910-53-54-973df08c-1f9913a17258917710f65fd2bc2b2658.png) You can then use the [Facebook's Sharing Debugger](https://developers.facebook.com/tools/debug/) to check how the link's preview looks after you added the Open Graph settings. ## Full list of parameters, descriptions and expected values[​](#full-list-of-parameters-descriptions-and-expected-values "Direct link to Full list of parameters, descriptions and expected values") Below is a list in alphabetical order of all the parameters, descriptions and expected values (if applicable) that can be set as social media metadata: | **Parameter** | **Description** / **Expected value** | | --------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | **audio** | URL to an audio file | | **description** | Page description | | **determiner** | A, an or the | | **image:alt** | Description of what is in the image | | **image:height** | Image height | | **image:width** | Image width | | **image:type** | Image MIME type | | **image** | Image URL | | **locale** | Locale of the page | | **locale:alternate** | Alternate locals of the page | | **site\_name** | Website name | | **title** | Page title | | **twitter:app:country** | X/Twitter app country | | **twitter:app:url:googleplay** | Your app URL in Google Play | | **twitter:app:id:googleplay** | Your app ID in Google Play | | **twitter:app:name:googleplay** | Name of your app in Google Play | | **twitter:app:url:ipad** | Your iPad app URL in Apple Store | | **twitter:app:id:ipad** | Your iPad app ID in Apple Store | | **twitter:app:name:ipad** | Name of your iPad app in Apple Store | | **twitter:app:url:iphone** | Your iPhone app URL in Apple Store | | **twitter:app:id:iphone** | Your iPhone | | **twitter:app:name:iphone** | Name of your iPhone app in Apple Store | | **twitter:player:stream** | URL to raw video or audio stream | | **twitter:player:height** | Height of iframe in pixels | | **twitter:player:width** | Width of iframe in pixels | | **twitter:player** | HTTPS URL of player iframe | | **twitter:image:alt** | A text description of the image | | **twitter:image** | URL of image to use in the card | | **twitter:title** | Title of content (max 70 characters) | | **twitter:description** | Description of content (max 200 characters) | | **twitter:creator:id** | X/Twitter user ID of content creator | | **twitter:creator** | @username of content creator | | **twitter:site:id** | X/Twitter website ID | | **twitter:site** | @username of website | | **twitter:card** | The X card type | | **type** | Page type: **article**, **book**, **profile**, **website**, **music.song**, **music.album**, **music.playlist**, **music.radio\_station**, **video.movie**, **video.episode**, **video.tv\_show**, **video.other** | | **url** | Canonical URL of your object |