Loading…
` is rendered. This could be updated to inherit the width and height of the oEmbed content and thus prevent reflows when it is replaced.\n\n## Miscellaneous\n\nSome components within `SocialEmbed` render the same result given the same props and are memoized using [React.memo](https://reactjs.org/docs/react-api.html#reactmemo) to prevent unnecessary renders.\n\n## Contributing\n\nPsammead is completely open source. We are grateful for any contributions, whether they be new components, bug fixes or general improvements. Please see our primary contributing guide which can be found at [the root of the Psammead repository](https://github.com/bbc/psammead/blob/latest/CONTRIBUTING.md).\n\n### [Code of Conduct](https://github.com/bbc/psammead/blob/latest/CODE_OF_CONDUCT.md)\n\nWe welcome feedback and help on this work. By participating in this project, you agree to abide by the [code of conduct](https://github.com/bbc/psammead/blob/latest/CODE_OF_CONDUCT.md). Please take a moment to read it.\n\n### License\n\nPsammead is [Apache 2.0 licensed](https://github.com/bbc/psammead/blob/latest/LICENSE).\n","_npmUser":{"name":"bbc-online","email":"PsammeadMaintainers@bbc.co.uk"},"repository":{"url":"https://github.com/BBC-News/psammead/tree/latest/packages/components/psammead-social-embed","type":"git"},"_npmVersion":"6.13.7","description":"A component that renders a rich social media embed or a fallback.","directories":{},"sideEffects":false,"_nodeVersion":"12.15.0","dependencies":{"@bbc/gel-foundations":"^4.0.1","@bbc/psammead-oembed":"0.1.0-alpha.2","@bbc/psammead-styles":"^4.3.0"},"publishConfig":{"tag":"alpha"},"_hasShrinkwrap":false,"readmeFilename":"README.md","peerDependencies":{"react":"^16.12.0","styled-components":"^4.4.1","@loadable/component":"^5.12.0"},"_npmOperationalInternal":{"tmp":"tmp/psammead-social-embed_0.1.0-alpha.2_1585128720723_0.5337718008275161","host":"s3://npm-registry-packages"}},"0.1.0-alpha.3":{"name":"@bbc/psammead-social-embed","version":"0.1.0-alpha.3","author":{"name":"Psammead Maintainers","email":"PsammeadMaintainers@bbc.co.uk"},"license":"Apache-2.0","_id":"@bbc/psammead-social-embed@0.1.0-alpha.3","maintainers":[{"name":"api-management-jenkins","email":"api@bbc.co.uk"},{"name":"audienceplatformdev","email":"AudiencePlatformDev@bbc.co.uk"},{"name":"bbc-admin","email":"npm-admins@lists.forge.bbc.co.uk"},{"name":"bbc-archivesearch-development-team","email":"ArchiveSearchDevelopmentTeam@bbc.co.uk"},{"name":"bbc-cd-jenkins","email":"ContentDiscoveryDevs@bbc.co.uk"},{"name":"bbc-gnl-ci","email":"WWGNDevelopmentTeam@bbc.com"},{"name":"bbc-isite","email":"isite-team@bbc.co.uk"},{"name":"bbc-morph","email":"morph-devops@bbc.co.uk"},{"name":"bbc-news-jenkins","email":"DigitalNewsIDTAdmin@bbc.co.uk"},{"name":"bbc-online","email":"PsammeadMaintainers@bbc.co.uk"},{"name":"bbc-voice-pipeline","email":"voice-development-team@lists.forge.bbc.co.uk"},{"name":"bbcconnections","email":"connections.techsupport@bbc.co.uk"},{"name":"bbcrd","email":"irfs@bbc.co.uk"},{"name":"bbcrd-artifactory","email":"artifactory@rd.bbc.co.uk"},{"name":"cps-jenkins","email":"platform-cps-prod-account@lists.forge.bbc.co.uk"},{"name":"cps-support","email":"CPSSupport2@bbc.co.uk"},{"name":"education-jenkins","email":"bitesize-engineering@lists.forge.bbc.co.uk"},{"name":"gel-jenkins","email":"gel-dev-account@lists.forge.bbc.co.uk"},{"name":"ibl","email":"ibl-team@lists.forge.bbc.co.uk"},{"name":"ibl-jenkins","email":"ibl-team@lists.forge.bbc.co.uk"},{"name":"insyn-jenkins","email":"D&EPlatformCDSSyndicationCore@bbc.co.uk"},{"name":"iplayer-web-jenkins","email":"responsive-iplayer@lists.forge.bbc.co.uk"},{"name":"iplayerradio-aws","email":"iplayerradio-aws-development@lists.forge.bbc.co.uk"},{"name":"itv-ci-machine","email":"ConnectedTV-Development@lists.forge.bbc.co.uk"},{"name":"kite-jenkins","email":"kite-dev@lists.forge.bbc.co.uk"},{"name":"locator-deploy","email":"D+ELocationServicesProjectTeam@bbc.co.uk"},{"name":"mdtbuild","email":"ise.jenkins@bbc.co.uk"},{"name":"media-playout-jenkins","email":"empsupport@bbc.co.uk"},{"name":"newslabs-jenkins","email":"newslabs-development@lists.forge.bbc.co.uk"},{"name":"participation-jenkins","email":"audienceparticipationdevs@bbc.co.uk"},{"name":"partner-platform-jenkins","email":"partnerplatformsupport@bbc.co.uk"},{"name":"pcs-amp-jenkins","email":"pcs-amp-development@lists.forge.bbc.co.uk"},{"name":"rmsdev","email":"radio-and-music-services-developer@lists.forge.bbc.co.uk"},{"name":"silver-jenkins","email":"D&ESilver.support@bbc.co.uk"},{"name":"sounds-web-jenkins","email":"sounds-web-jenkins@bbc.co.uk"},{"name":"sport-web-jenkins","email":"sport-web-jenkins-caretakers@lists.forge.bbc.co.uk"},{"name":"travel-jenkins","email":"bbclocaljenkins@gmail.com"},{"name":"weather-jenkins","email":"DigitalWeatherDevs@bbc.co.uk"}],"homepage":"https://github.com/BBC-News/psammead/blob/latest/packages/components/psammead-social-embed/README.md","bugs":{"url":"https://github.com/bbc/psammead/issues"},"dist":{"shasum":"d25467c2a14d5a8fed52e105a84bce90b205fc9e","tarball":"https://registry.npmjs.org/@bbc/psammead-social-embed/-/psammead-social-embed-0.1.0-alpha.3.tgz","fileCount":34,"integrity":"sha512-/4YJRHeBclSHxPzM6O/Q5gS5/1vvpm5xLwjg1An5hLq0x8570OUNAVw3AorWeUSXY5BxYl0Kug4IGWuI/MbenA==","signatures":[{"sig":"MEQCIEBTNTlEJuSuKy2l8/ihYZq+We4ImMGgxc2pFIlvVptbAiBP4eCgNe/dp3mnFCAZIuRqRfuGUxapjfD6g9co5o2sfg==","keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA"}],"unpackedSize":116009,"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v3.0.4\r\nComment: https://openpgpjs.org\r\n\r\nwsFcBAEBCAAQBQJefdf1CRA9TVsSAnZWagAAIGwP/3XaRIh9LQoCoLmFESHG\nI+nm0VkaVSApniPl+yvzAML1leTodF108kOv8TxnxU4KMeqtBjtU4LgHrsqr\nlmyO7D5NxoytL4xMTVO/QMyI/aqrJluLbN5teajGq2MbK4EezHEv0vpYQwC1\nJHpC5H78Zsq8XMXg4W7sZ6dsc52KF368qU5WIYJ4+Sn0Oo6txDzO/KtKx9FO\nJuI8x/X9FvBQsSsiBLm1lSh2B9dj+URGlyi0N7+JuB6o0qxanFU2qlAXN813\njPDMVtR4SMcFYZIDyVSXxDdJBt+GeKjZFAmAciFkxczLCLL9i0cF/yiaOXpE\nmJAHZ2Ac+lPQIHtuL4ldpYXYpURB+tFMNl/WfC4qBbDYdRBF9/LrkjbQdw4j\nviHYG4JoE9g8itGVTG48lYG9rYrrvim8A607iESlPh71tt2cCh3tEyykhG7u\njr9kCDV+QS7hc1OXX5aUJLX9k/XvCaoZafsHpOpNVW1tLqJMcnhpnlf+n6uj\n8C57zA5nb/8AALDDbptBIAGLr2x9izYypSBK+2ON5lbrYFNGdcS1+FJU4qtu\natF+5pwWO+vWiwE0U/v+wGW9SRm/W/XbvF/JIPPj7XyIl5asDfj+QSoLBufx\niSASe20B7R6vLpcqLyn3B+5q9LKTtbbRBUkNtyWuro89k/+z1jYbDJw604gK\n45w5\r\n=GX/a\r\n-----END PGP SIGNATURE-----\r\n"},"main":"dist/index.js","module":"esm/index.js","readme":"# ⛔️ This is an alpha component ⛔️\n\nThis component is currently tagged as alpha and is not suitable for production use. Following the passing of an accessibility review this component will be marked as ready for production and the alpha tag removed.\n\n# psammead-social-embed - [](https://snyk.io/test/github/bbc/psammead?targetFile=packages%2Fcomponents%2Fpsammead-social-embed%2Fpackage.json) [](https://david-dm.org/bbc/psammead?path=packages/components/psammead-social-embed) [](https://david-dm.org/bbc/psammead?path=packages/components/psammead-social-embed&type=peer) [](https://bbc.github.io/psammead/?path=/story/social-embed--containing-image) [](https://github.com/bbc/psammead/blob/latest/LICENSE) [](https://www.npmjs.com/package/@bbc/psammead-social-embed) [](https://github.com/bbc/psammead/blob/latest/CONTRIBUTING.md)\n\n## Description\n\nThe `SocialEmbed` component renders a rich social media embed for a number of supported providers or a fallback containing a link to the source content.\n\nNote: This component declares `@loadable/component` as a peer dependency. It is used to dynamically import `@bbc/psammead-oembed` if and when it's needed.\n\n### Supported providers\n\n| Name | Value |\n| --------- | ----------- |\n| Instagram | `instagram` |\n| Twitter | `twitter` |\n| YouTube | `youtube` |\n\n## Installation\n\n```\nnpm install @bbc/psammead-social-embed --save\n```\n\n## Props\n\n### Canonical\n\n| Argument | Type | Required | Default | Example |\n| ---------- | ------ | -------- | ------- | ------------------------------------------------------------------------------------------------------------------- |\n| `provider` | String | Yes | n/a | See [supported providers](#supported-providers). |\n| `service` | String | Yes | n/a | `'news'` |\n| `oEmbed` | Object | Yes | n/a | See [@bbc/psammead-oembed](https://github.com/bbc/psammead/tree/latest/packages/components/psammead-oembed#oembed). |\n| `fallback` | Object | Yes | n/a | See [fallback](#fallback). |\n| `skipLink` | Object | Yes | n/a | See [skipLink](#skipLink). |\n| `caption` | Object | Yes | n/a | See [caption](#caption). |\n\n### AMP\n\n| Argument | Type | Required | Default | Example |\n| ---------- | ------ | -------- | ------- | ------------------------------------------------ |\n| `provider` | String | Yes | n/a | See [supported providers](#supported-providers). |\n| `service` | String | Yes | n/a | `'news'` |\n| `id` | String | Yes | n/a | `'1237210910835392512'` |\n| `fallback` | Object | Yes | n/a | See [fallback](#fallback). |\n| `skipLink` | Object | Yes | n/a | See [skipLink](#skipLink). |\n| `caption` | Object | Yes | n/a | See [caption](#caption). |\n\n### `fallback`\n\n| Argument | Type | Required | Default | Example |\n| ------------- | ------ | -------- | ------- | ------------------------------------------------------------- |\n| `text` | String | Yes | n/a | `\"Sorry but we're having trouble displaying this content\"` |\n| `linkText` | String | Yes | n/a | `'View content on %provider_name%'` |\n| `linkHref` | String | Yes | n/a | `'https://twitter.com/MileyCyrus/status/1237210910835392512'` |\n| `warningText` | String | No | `null` | `Warning: BBC is not responsible for third party content` |\n\nNote: For your convenience, instances of `%provider%` and `%provider_name%` in the above strings will be replaced with the current provider and, where the provider is known, the name of the provider. E.G. `twitter` and `Twitter` respectively.\n\n### `skipLink`\n\n| Argument | Type | Required | Default | Example |\n| ----------- | ------ | -------- | ------- | ---------------------------------- |\n| `text` | String | Yes | n/a | `'Skip %provider_name% content'` |\n| `endTextId` | String | Yes | n/a | `'skip-%provider%-content'` |\n| `endText` | String | Yes | n/a | `'End of %provider_name% content'` |\n\n### `caption`\n\n| Argument | Type | Required | Default | Example |\n| -------------------- | ------ | -------- | ------- | ---------------------------------------------------- |\n| `visuallyHiddenText` | String | Yes | n/a | `'Video caption,'` |\n| `text` | String | Yes | n/a | `'Warning: Third party content may contain adverts'` |\n\nNote: `visuallyHiddenText` will come before `text` and have a trailing space added.\n\nSee [accessibility notes](#accessibility-notes) for more information.\n\nNote: For your convenience, instances of `%provider%` and `%provider_name%` in the above strings will be replaced with the current provider and, where the provider is known, the name of the provider. E.G. `instagram` and `Instagram` respectively.\n\n## Usage\n\n### Canonical\n\nPass a [supported provider](#supported-providers) and valid oEmbed response. If neither of these cases can be met, a fallback will be rendered containing a link to the source content.\n\n#### Example\n\n```jsx\nimport { CanonicalSocialEmbed } from '@bbc/psammead-social-embed';\n\nLoading…
` is rendered. This could be updated to inherit the width and height of the oEmbed content and thus prevent reflows when it is replaced.\n\n## Miscellaneous\n\nSome components within `SocialEmbed` render the same result given the same props and are memoized using [React.memo](https://reactjs.org/docs/react-api.html#reactmemo) to prevent unnecessary renders.\n\n## Contributing\n\nPsammead is completely open source. We are grateful for any contributions, whether they be new components, bug fixes or general improvements. Please see our primary contributing guide which can be found at [the root of the Psammead repository](https://github.com/bbc/psammead/blob/latest/CONTRIBUTING.md).\n\n### [Code of Conduct](https://github.com/bbc/psammead/blob/latest/CODE_OF_CONDUCT.md)\n\nWe welcome feedback and help on this work. By participating in this project, you agree to abide by the [code of conduct](https://github.com/bbc/psammead/blob/latest/CODE_OF_CONDUCT.md). Please take a moment to read it.\n\n### License\n\nPsammead is [Apache 2.0 licensed](https://github.com/bbc/psammead/blob/latest/LICENSE).\n","_npmUser":{"name":"bbc-online","email":"PsammeadMaintainers@bbc.co.uk"},"repository":{"url":"https://github.com/BBC-News/psammead/tree/latest/packages/components/psammead-social-embed","type":"git"},"_npmVersion":"6.13.7","description":"A component that renders a rich social media embed or a fallback.","directories":{},"sideEffects":false,"_nodeVersion":"12.15.0","dependencies":{"@bbc/gel-foundations":"^4.0.1","@bbc/psammead-oembed":"0.1.0-alpha.2","@bbc/psammead-styles":"^4.3.0"},"publishConfig":{"tag":"alpha"},"_hasShrinkwrap":false,"readmeFilename":"README.md","peerDependencies":{"react":"^16.12.0","styled-components":"^4.4.1","@loadable/component":"^5.12.0"},"_npmOperationalInternal":{"tmp":"tmp/psammead-social-embed_0.1.0-alpha.3_1585305588501_0.2950893608363663","host":"s3://npm-registry-packages"}},"0.1.0-alpha.4":{"name":"@bbc/psammead-social-embed","version":"0.1.0-alpha.4","author":{"name":"Psammead Maintainers","email":"PsammeadMaintainers@bbc.co.uk"},"license":"Apache-2.0","_id":"@bbc/psammead-social-embed@0.1.0-alpha.4","maintainers":[{"name":"api-management-jenkins","email":"api@bbc.co.uk"},{"name":"audienceplatformdev","email":"AudiencePlatformDev@bbc.co.uk"},{"name":"bbc-admin","email":"npm-admins@lists.forge.bbc.co.uk"},{"name":"bbc-archivesearch-development-team","email":"ArchiveSearchDevelopmentTeam@bbc.co.uk"},{"name":"bbc-cd-jenkins","email":"ContentDiscoveryDevs@bbc.co.uk"},{"name":"bbc-gnl-ci","email":"WWGNDevelopmentTeam@bbc.com"},{"name":"bbc-isite","email":"isite-team@bbc.co.uk"},{"name":"bbc-morph","email":"morph-devops@bbc.co.uk"},{"name":"bbc-news-jenkins","email":"DigitalNewsIDTAdmin@bbc.co.uk"},{"name":"bbc-online","email":"PsammeadMaintainers@bbc.co.uk"},{"name":"bbc-voice-pipeline","email":"voice-development-team@lists.forge.bbc.co.uk"},{"name":"bbcconnections","email":"connections.techsupport@bbc.co.uk"},{"name":"bbcrd","email":"irfs@bbc.co.uk"},{"name":"bbcrd-artifactory","email":"artifactory@rd.bbc.co.uk"},{"name":"cps-jenkins","email":"platform-cps-prod-account@lists.forge.bbc.co.uk"},{"name":"cps-support","email":"CPSSupport2@bbc.co.uk"},{"name":"education-jenkins","email":"bitesize-engineering@lists.forge.bbc.co.uk"},{"name":"gel-jenkins","email":"gel-dev-account@lists.forge.bbc.co.uk"},{"name":"ibl","email":"ibl-team@lists.forge.bbc.co.uk"},{"name":"ibl-jenkins","email":"ibl-team@lists.forge.bbc.co.uk"},{"name":"insyn-jenkins","email":"D&EPlatformCDSSyndicationCore@bbc.co.uk"},{"name":"iplayer-web-jenkins","email":"responsive-iplayer@lists.forge.bbc.co.uk"},{"name":"iplayerradio-aws","email":"iplayerradio-aws-development@lists.forge.bbc.co.uk"},{"name":"itv-ci-machine","email":"ConnectedTV-Development@lists.forge.bbc.co.uk"},{"name":"kite-jenkins","email":"kite-dev@lists.forge.bbc.co.uk"},{"name":"locator-deploy","email":"D+ELocationServicesProjectTeam@bbc.co.uk"},{"name":"mdtbuild","email":"ise.jenkins@bbc.co.uk"},{"name":"media-playout-jenkins","email":"empsupport@bbc.co.uk"},{"name":"newslabs-jenkins","email":"newslabs-development@lists.forge.bbc.co.uk"},{"name":"participation-jenkins","email":"audienceparticipationdevs@bbc.co.uk"},{"name":"partner-platform-jenkins","email":"partnerplatformsupport@bbc.co.uk"},{"name":"pcs-amp-jenkins","email":"pcs-amp-development@lists.forge.bbc.co.uk"},{"name":"rmsdev","email":"radio-and-music-services-developer@lists.forge.bbc.co.uk"},{"name":"silver-jenkins","email":"D&ESilver.support@bbc.co.uk"},{"name":"sounds-web-jenkins","email":"sounds-web-jenkins@bbc.co.uk"},{"name":"sport-web-jenkins","email":"sport-web-jenkins-caretakers@lists.forge.bbc.co.uk"},{"name":"travel-jenkins","email":"bbclocaljenkins@gmail.com"},{"name":"weather-jenkins","email":"DigitalWeatherDevs@bbc.co.uk"}],"homepage":"https://github.com/BBC-News/psammead/blob/latest/packages/components/psammead-social-embed/README.md","bugs":{"url":"https://github.com/bbc/psammead/issues"},"dist":{"shasum":"6a1a58e975cae3516269702d0b3508f7af5e4f3d","tarball":"https://registry.npmjs.org/@bbc/psammead-social-embed/-/psammead-social-embed-0.1.0-alpha.4.tgz","fileCount":34,"integrity":"sha512-k5rLqS9y9G8RnnmA4kreQOqqt5woJfp/sQc7tL+UYXO1ujI0CftkNjlcfl+ua8HX4D7k2AbSNjjlJyCMElUzsQ==","signatures":[{"sig":"MEUCID06wV6ZUZ8NRx6ytFNEigvyYNzhI/aSp2gMqNbrnjFLAiEAnPLLUmtlYS7LiBjmnBM5VjAd7LXbcIbNk6ysF1yLeoY=","keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA"}],"unpackedSize":118077,"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v3.0.4\r\nComment: https://openpgpjs.org\r\n\r\nwsFcBAEBCAAQBQJeg0NACRA9TVsSAnZWagAAItgP/2gW8uFfY0BERWZwEQJm\no3ML5CbUUTWvAf+P31AK2dtIXoV+1I+st4MVk6+BRzMulP8H+TtKc4xgmsRz\nkoG888JD6FMM2PgsVfVdNP3kohICuB2CVEmvWPE9btFVTsr/cw7EgNtdwE3g\nenC/y2UkMQsWLupUj7IGOC4lYZWlTiCp6DOI8RIx4/zeR9kWmyZVIDtvn/px\nmJB6cHyVuSk/duYJ5rSSbHLp0vUZAhZ4KtM0z0KiZr7ueFBuPcvts5BaSGs3\nYJHphXIpiu/Gm5FkZQt2N6Z4jFAUMzrHDbMbaVC/eXpYUothJBw0yWNGfQx5\n8Z48zBHo+HxI21gfdAps+j3D5cvhsiW3vAZyhN5siBZJ3YdExGXeeUkP0ufk\n/lwkUjOW/GQqO0LLS/imBKNpyFZg8WzrEpJaBu3x/LqhDcQA9adAWZZaO9eX\nYwOUp1eqYtNbc6Jvbg1ADOf6/+N2VgbL4h2Sxlh6C5Yv01ZkZXyNMIen6kYY\n765tr9UJvz1DmBAMwCBmjAl7XkIWmhi4+WRYx63f4hlqLcbtZXmUEL8S2JLX\nAIH+ZW0xfqJyxB9IG+JsGm6dqZVvQoyl5jVU5/PM3SnP+F+QijAkIQAD4WdS\n4R2Kwzq3PqvE7XMAuPD6pUorOXBLNFlt7Kkixg+NK3Gb8yWLsszToUnoWJRb\nD9pE\r\n=kZ8W\r\n-----END PGP SIGNATURE-----\r\n"},"main":"dist/index.js","module":"esm/index.js","readme":"# ⛔️ This is an alpha component ⛔️\n\nThis component is currently tagged as alpha and is not suitable for production use. Following the passing of an accessibility review this component will be marked as ready for production and the alpha tag removed.\n\n# psammead-social-embed - [](https://snyk.io/test/github/bbc/psammead?targetFile=packages%2Fcomponents%2Fpsammead-social-embed%2Fpackage.json) [](https://david-dm.org/bbc/psammead?path=packages/components/psammead-social-embed) [](https://david-dm.org/bbc/psammead?path=packages/components/psammead-social-embed&type=peer) [](https://bbc.github.io/psammead/?path=/story/social-embed--containing-image) [](https://github.com/bbc/psammead/blob/latest/LICENSE) [](https://www.npmjs.com/package/@bbc/psammead-social-embed) [](https://github.com/bbc/psammead/blob/latest/CONTRIBUTING.md)\n\n## Description\n\nThe `SocialEmbed` component renders a rich social media embed for a number of supported providers or a fallback containing a link to the source content.\n\n### Supported providers\n\n| Name | Value |\n| --------- | ----------- |\n| Instagram | `instagram` |\n| Twitter | `twitter` |\n| YouTube | `youtube` |\n\n## Installation\n\n```\nnpm install @bbc/psammead-social-embed --save\n```\n\n## Props\n\n### Canonical\n\n| Argument | Type | Required | Default | Example |\n| ---------- | ------ | -------- | ------- | ------------------------------------------------------------------------------------------------------------------- |\n| `provider` | String | Yes | n/a | See [supported providers](#supported-providers). |\n| `service` | String | Yes | n/a | `'news'` |\n| `oEmbed` | Object | Yes | n/a | See [@bbc/psammead-oembed](https://github.com/bbc/psammead/tree/latest/packages/components/psammead-oembed#oembed). |\n| `fallback` | Object | Yes | n/a | See [fallback](#fallback). |\n| `skipLink` | Object | Yes | n/a | See [skipLink](#skipLink). |\n| `caption` | Object | No | `null` | See [caption](#caption). |\n\n### AMP\n\n| Argument | Type | Required | Default | Example |\n| ---------- | ------ | -------- | ------- | ------------------------------------------------ |\n| `provider` | String | Yes | n/a | See [supported providers](#supported-providers). |\n| `service` | String | Yes | n/a | `'news'` |\n| `id` | String | Yes | n/a | `'1237210910835392512'` |\n| `fallback` | Object | Yes | n/a | See [fallback](#fallback). |\n| `skipLink` | Object | Yes | n/a | See [skipLink](#skipLink). |\n| `caption` | Object | No | `null` | See [caption](#caption). |\n\n### `fallback`\n\n| Argument | Type | Required | Default | Example |\n| ------------------------------ | ------ | -------- | ------- | ------------------------------------------------------------- |\n| `text` | String | Yes | n/a | `\"Sorry but we're having trouble displaying this content\"` |\n| `linkText` | String | Yes | n/a | `'View content on %provider_name%'` |\n| `linkTextSuffixVisuallyHidden` | String | No | `null` | `', external'` |\n| `linkHref` | String | Yes | n/a | `'https://twitter.com/MileyCyrus/status/1237210910835392512'` |\n| `warningText` | String | No | `null` | `Warning: BBC is not responsible for third party content` |\n\n### `skipLink`\n\n| Argument | Type | Required | Default | Example |\n| ----------------------- | ------ | -------- | ------- | ---------------------------------- |\n| `text` | String | Yes | n/a | `'Skip %provider_name% content'` |\n| `endTextId` | String | Yes | n/a | `'skip-%provider%-content'` |\n| `endTextVisuallyHidden` | String | Yes | n/a | `'End of %provider_name% content'` |\n\n### `caption`\n\n| Argument | Type | Required | Default | Example |\n| -------------------------- | ------ | -------- | ------- | ---------------------------------------------------- |\n| `textPrefixVisuallyHidden` | String | No | `null` | `'Video caption,'` |\n| `text` | String | Yes | n/a | `'Warning: Third party content may contain adverts'` |\n\nSee [accessibility notes](#accessibility-notes) for more information.\n\nNote: For your convenience, instances of `%provider%` and `%provider_name%` in `fallback`, `skipLink` and `caption` strings will be replaced with the current provider and, where the provider is known, the name of the provider. E.G. `youtube` and `YouTube` respectively.\n\n## Usage\n\n### Canonical\n\nPass a [supported provider](#supported-providers) and valid oEmbed response. If neither of these cases can be met, a fallback will be rendered containing a link to the source content.\n\n#### Example\n\n```jsx\nimport { CanonicalSocialEmbed } from '@bbc/psammead-social-embed';\n\n