How do I set a custom homepage for Google Chrome on macOS?

Use a Plist file to define the `HomepageLocation` and import it into your macOS policy configuration.

What is the Plist key for setting the Chrome homepage URL?

The Plist key is `HomepageLocation`. Set its string value to your desired URL.

How do I import the Chrome homepage Plist into Applivery?

In the Applivery Dashboard, go to Policies, add a configuration, and import the Plist using either copy/paste or upload XML.

What Plist key controls the new tab page in Chrome?

The `NewTabPageLocation` key in the Plist controls the URL for the new tab page.

Where can I find the Applivery Dashboard to configure Chrome policies?

Access the Applivery Dashboard at dashboard.applivery.io.

After importing the Chrome configuration, how do I verify it?

Restart Google Chrome to ensure the new homepage configuration has been applied.

What file type do I upload to configure the Chrome homepage?

You upload an XML file containing the Plist configuration.

Google Chrome Homepage Configuration

Configuring the homepage allows IT admins to control the content displayed when users launch the browser.

Use the following Plist to set a homepage URL for the Google Chrome browser. Copy the contents from below and import them into the relevant macOS Policy.

Chrome Homepage Plist

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
	<key>PayloadContent</key>
	<array>
		<dict>
			<key>HomepageLocation</key>
			<string>https://www.applivery.com</string>
			<key>NewTabPageLocation</key>
			<string>https://www.applivery.com/docs</string>
			<key>PayloadDisplayName</key>
			<string>Google Chrome</string>
			<key>PayloadIdentifier</key>
			<string>com.google.Chrome.F8C05D93-31F5-416E-AF46-2E54F2578F9A</string>
			<key>PayloadType</key>
			<string>com.google.Chrome</string>
			<key>PayloadUUID</key>
			<string>B98A135C-3F21-40E9-9D0C-CD9E4A5A46A6</string>
			<key>PayloadVersion</key>
			<integer>1</integer>
		</dict>
	</array>
</dict>
</plist>

Replace the home page URL with the URL that you would like to use in the above Payload. For example:

<key>HomepageLocation</key>
<string>https://www.applivery.com</string>
<key>NewTabPageLocation</key>
<string>https://www.applivery.com/docs</string>

Once in the Applivery Dashboard, go to any of your Policies (1) or create a new one.

Click the + Add configuration button on the left-hand menu, then click the + Import (2) button.

You can either copy the Plist above or use the Upload XML button to upload a new one.

Note

Restart Google Chrome to verify that the configuration has been applied correctly.

Key Takeaways