[[["易于理解","easyToUnderstand","thumb-up"],["解决了我的问题","solvedMyProblem","thumb-up"],["其他","otherUp","thumb-up"]],[["很难理解","hardToUnderstand","thumb-down"],["信息或示例代码不正确","incorrectInformationOrSampleCode","thumb-down"],["没有我需要的信息/示例","missingTheInformationSamplesINeed","thumb-down"],["翻译问题","translationIssue","thumb-down"],["其他","otherDown","thumb-down"]],["最后更新时间 (UTC):2025-07-31。"],[],[],null,["# Private embedding\n\nIn addition to [public embedding](/looker/docs/publishing-looks-with-public-urls#embed), you can also embed Looks, Explores, and dashboards privately. With private embedding, you can require a user to authenticate using a Looker login, [Google OAuth](/looker/docs/admin-panel-authentication-google), or [OpenID Connect](/looker/docs/admin-panel-authentication-openid-connect). If a user is not authenticated, you have the option to show an error message or [display a login screen](#enable_login_screen_for_private_embeds).\n\nUsers who are logged in and accessing privately embedded content are subject to the settings in the [**Sessions**](/looker/docs/admin-panel-authentication-sessions) **Admin** panel, which determine how long they can stay logged in, if they can log in from multiple browsers, and if they will be logged out after a period of inactivity.\n\nIf you require a more advanced or customizable embedded solution, check out our [Signed embedding](/looker/docs/single-sign-on-embedding) documentation page.\n| **Note:** Embedded content always reflects the production version of the content. Any changes made while in [Development Mode](/looker/docs/dev-mode-prod-mode) that affect content and that have not been deployed to production won't appear in an embed.\n\nGenerating an embed URL\n-----------------------\n\nTo generate and copy a [private embed URL](/looker/docs/private-embedding) for a dashboard, a Look, or an Explore visualization, select **Get embed URL** from a dashboard [three-dot menu](/looker/docs/viewing-dashboards#three-dot_dashboard_menu), or from the Explore action gear menu on an [Explore](/looker/docs/viewing-and-interacting-with-explores#the_explore_actions_gear_menu) or a [Look](/looker/docs/viewing-looks#the_look_explore_actions_gear_menu).\n\nThe **Private Embed** screen includes the following elements:\n\n1. The **Content URL** field shows the full private embed URL.\n2. The **Apply theme to dashboard URL** field lets you select a theme to be added to the embed URL if you are generating a dashboard or an Explore embed URL and your instance has [custom themes](/looker/docs/themes-for-embedded-dashboards-and-explores) enabled. The theme will be applied when the embedded dashboard or Explore is viewed.\n3. The **Include current params in URL** switch lets you choose whether to apply current parameters, such as filter values, to the embed URL. If enabled, those parameters will be applied when the embedded content is viewed.\n4. Select the **Copy Link** button to copy the full embed URL to your clipboard.\n\nOnce you've generated and copied the embed URL, you can paste the URL into a new browser window or tab to preview the embedded content. You can also use this URL to [embed the content in an iframe](#viewing_the_embedded_content_in_an_iframe).\n\nPreviewing the embedded content\n-------------------------------\n\nPaste your embed URL in your browser to preview your embed content's behavior and appearance.\n\nViewing the embedded content in an iframe\n-----------------------------------------\n\nPlace the embed URL into an iframe. For example: \n\n \u003ciframe\n src=\"https://instance_name.cloud.looker.com/embed/dashboards/1\"\n width=\"1000\"\n height=\"2000\"\n frameborder=\"0\"\u003e\n \u003c/iframe\u003e\n\nAnd then embed the iframe as desired.\n\n### Changing the embedded appearance of a dashboard\n\nViewing a dashboard with `/embed` in the URL shows you how the dashboard will appear when it's embedded.\n\nBy default, an embedded dashboard is displayed using the [default theme](/looker/docs/themes-for-embedded-dashboards-and-explores#default_theme) for your Looker instance. You can change the appearance of your embedded dashboard in several ways, depending on the type of dashboard you are using:\n\n- For any type of dashboard, you can specify a different theme name [in the embed URL](/looker/docs/themes-for-embedded-dashboards-and-explores#specify_theme) to change the theme used to display the dashboard.\n- For any type of dashboard, you can use the [`_theme` URL argument](/looker/docs/themes-for-embedded-dashboards-and-explores#using_the__theme_url_argument_to_apply_individual_dashboard_theme_elements) to change individual dashboard theme elements.\n- For a [LookML dashboard](/looker/docs/building-lookml-dashboards), you can also modify the embedded appearance of a dashboard through the [`embed_style`](/looker/docs/reference/param-lookml-dashboard#embed_style) parameter.\n\nUsing the `theme` URL argument, the **Edit Embed Settings** option, or the `embed_style` parameter makes changes only to the dashboard the argument, option, or parameter is applied to. If you want to customize the appearance of multiple embedded dashboards, use a [theme](/looker/docs/themes-for-embedded-dashboards-and-explores) instead.\n\nSome display settings override others. For more information, see the [Creating and applying themes for embedded dashboards and Explores](/looker/docs/themes-for-embedded-dashboards-and-explores#themes_precedence) documentation page.\n\nEnable login screen for private embeds\n--------------------------------------\n\nYou can add the parameter `allow_login_screen=true` to your embed URL if you want to display a login screen to users who haven't logged in already. For example: \n\n \u003ciframe src=\"https://instance_name.cloud.looker.com/embed/looks/4?allow_login_screen=true\"\u003e\u003c/iframe\u003e\n ^^^^^^^^^^^^^^^^^^^^^^^\n\nIf you do not add this parameter, a 401 error will be displayed to users who are not already logged in.\n| **Note:** Using [same-origin protections for your Looker login pages](/looker/docs/admin-panel-platform-embed#same-origin_protections_for_looker_login_pages) might prevent you from enabling a login screen for private embeds."]]