Advanced Settings
Spaces have several advanced settings which can be used to augment your Space's appearance and functionality. This page describes those features and identifies which types of accounts have access to those features.
What to know
- Advanced Settings can be accessed by clicking on your Space's Settings and then scrolling to the very bottom.
- Certain settings may not be available to you, depending on your plan.
General
The General panel contains options that affect key appearance or functionality features within your Space.
Allow targeting to multiple URLs
Publish
Enable this option to set multiple URLs for a single content entry. These URLs can be targeted as part of Targeting content to specific audiences.
The video below demonstrates this feature. The user navigates to Advanced Settings and then turns on the toggle for Allow targeting to multiple URLs. Then, within the Targeting menu for a content entry, there is a new option to add an additional URL for targeting.
Show studio tab
Publish
The studio tab provides a way to preview your application within Builder. You can adjust the URL, device settings, and other targeting variables to preview your application.
The video below demonstrates enabling the Show studio tab option and then navigating to the Studio view. There, the user updates the URL and tests the homepage using two different Audience attributes.
Hide getting started info
Publish
In a completely new Space, Builder displays some tutorials on the Content tab. Disabling this setting hides those guides.
Hide dark mode
This option disables Dark Mode for all users within the Space, forcing all users on Light Mode.
Performance
The Performance panel contains options that may improve how Builder operates with your application. These options are not necessary for most applications, but may improve the performance of certain applications encountering issues.
Use debounced edits in content editor
Enable this option delay changes within the Visual Editor. This option can be helpful in some rare instances where the behavior of the Visual Editor appears delayed.
The video below demonstrates this feature. The user navigates to Advanced Settings and then turns on the toggle for Use debounced edits in content editor. Then, they try changing the highlighting of text within a content entry. There is a minor delay between the application of the highlight and the preview's appearance.
Debounce text edits
Enable this option delay changes within the Visual Editor for only text edits. This option can be helpful in some rare instances where the behavior of the Visual Editor appears delayed.
Editor
The Editor panel contains options that specifically adjust the Visual Editor. These options can make working with the Visual Editor more efficient and seamless.
Use default margins
By default, Builder adds 20px margins to new blocks added to your content entry. When toggled off, this default is disabled.
Use default styles
By default, Builder adds some default styles to each block or layer, such as using flexbox layout for some blocks.Turning this off may make some style controls, such as alignment, not behave as expected.
Allow images in rich text editor
Enabling this option lets you add images within Text blocks. Typically, images are added as their own Image block.
Show inline text editing option
With Text blocks, it is possible to Edit text inline by default. To disable this option for all members of a Space, toggle this option off.
The video below demonstrates enabling inline text editing.
Show Shopify blocks
Publish
Unless you have Setup the Shopify plugin, Builder's Shopify blocks are not displayed. Turning on this option displays these blocks, even if Shopify's integration is not complete.
Advanced Preview URL logic
This setting lets you write custom code to compute the Preview URL of any model, based on the content custom fields and targeting attributes. This setting is on by default. For more details, visit Dynamic Preview URLs.
Only use inherited fonts
This setting stops Builder content from downloading fonts when loading on your website. Instead, only system fonts and fonts that are present on your website are available for Builder content. Once checked, this applies only for new content, not existing content.
Hide the "Link URL" field on all blocks
Hides the "Link URL" input field for all blocks. Useful if you would like to stop people from manually adding links in your content.
Use patch updates
Turn this setting on to have the editor use alternative content preview logic. By default, the Visual Editor does not refresh the entire view on change, as it can lead to slow experiences with significantly complex content entries. By turning this setting on, each change to the content entry, results in a full refresh.
Hide locale selector
Publish
This setting, when enabled, hides the locale selector on the Visual Editor page. This is useful if you wish to have more control over how locales are implemented within your application.
Use current locale to validate required fields
When enabled, content entry fields that are localized and marked as required are validated based on the value entered for the selected locale. This is useful in situations where you require different values for different locales, but the field is always required.
Show locale integration error dialog
Display an error dialogue to users when localized fields are present but the locale parameter has not been correctly integrated with your SDK. While this error may show in the Visual Editor, your production application may not have any issues. To disable this error, turn this setting off.
Enforce custom component validation
When enabled, custom component validation errors will block publishing. Users must fix all required fields and validation errors before they can publish content.
Enforce required subfield validation
When enabled, validates required fields nested within object, list, or array type inputs in custom components. This ensures all nested required fields are filled before publishing.
Advanced
The Advanced panel generally contains options that are more technical in nature, such as managing proxy previews or customizing webhooks.
Proxy previews
When previewing and editing, proxy your site through our servers to allow iframe access. Enable this setting to allow editing and previewing if you have x-frame-options or content-security-policy headers that block loading your site in any iframes.
Allow overriding locales
When enabled, create case-sensitive locale variants to create custom locale codes that differ only in case from official locales.
For example, when this setting is enabled, it is possible to have both "en-gb" and "en-GB" locales.
Reload preview on URL path change
Turn this off to not change the Preview URL based on the targeted URL path. When on, the preview iframe changes to the URL path specified in the URL targeting, if applicable.
In the video below, both states of this setting are displayed. Notice how, with the setting enabled, any change to the URL refreshes the page. When the setting is disabled, the page is not refreshed on URL change.
Restrict code generation to quality mode only
Publish
Enterprise plans
Enabling this setting requires all users of the Space to use Quality Mode when generating code, disabling the Fast Mode option.
Reload preview on device size change
Turn this on to reload the preview using a mobile user agent when editing and previewing for mobile. This is useful if you serve a different mobile site based on user agent, as opposed to screen size. Requires having our Chrome extension installed when editing and previewing.
Target React Native
Turn this on to indicate that you intend to deploy your content to React Native. Enabling this setting restricts the visual editor to prevent anyone in your Builder Space from creating content that does not work in React Native.
Under Strict React Native Style Validation, choose what level of warning or error you'd like to appear when a React Native issue occurs.
In the video below, this setting is enabled and the page is refreshed, demonstrating what the React Native errors look like.
Show blocks field type
By default, the blocks field type is hidden when creating a model field. Enabling this setting shows the blocks field type in the model fields editor list when adding or modifying model fields. This is only necessary for complex and customized situations.
Enable Locale Picker for Content List
If your Space makes use of Localization, and this setting is enabled, a dropdown appears on your Content tab that lest you filter content entries based on their locale.
Default Paper Size for PDF Export
As it says, this setting configures the default page size that is used when exporting content. Keep in mind that page size impacts which breakpoint is used for the export.
Trigger Webhook on Content Update
Turn this setting on to trigger webhooks when content is updated in the main Space. This requires your content to be in sync. For more about environments, visit Set up environments.
Allow Headers for Get API Requests
When using the API Data panel within the Data tab, you can make external requests by clicking the + API Data Source button. Typically, no headers can be set for these requests.
By enabling this feature, headers can be set as part of the API request.
Smart targeting features
Builder Smart Targeting uses historical API logs to suggest targeting attribute values, which in turn saves time, reduces errors, and provides customer data platform (CDP) insights.
By default, smart targeting is disabled. To learn more, visit Smart targeting.
Edit Webhooks and Validation Hooks Per Environment
Turn this setting on to allow for webhooks to be customized on a per environment basis. Changes do not sync across environments, so if you wish to have a similar webhook in all environments you must create the webhook in each one. For more about environments, visit Set up environments.
Allow Search Engine Crawling of Images
When enabled, removes the X-Robots-Tag no-crawl header from image responses, allowing search engines to index and crawl your images.
Omit Hidden Layers from HTML
Remove hidden blocks at all breakpoints from the rendered HTML output. Reduces bandwidth by preventing bots from fetching assets inside invisible elements. Can also be enabled for individual Models.
Restrict Public API Key from Querying Unpublished Content
When enabled, the public API key cannot use includeUnpublished=true or published.$ne filters. Only private API keys can query draft or archived content.
Labs
The Labs panel contains experimental features. These features are often not fully complete, which means you may encounter issues when using them.
Allow absolute position editing
This adds access to a Canvas block within the Visual Editor.
What's next
Read more about Builder and Integrations, or learn about other ways to Add context to projects.