Group-Based Homepages - 2023.3.4 and Later¶

Alation Cloud Service Applies to Alation Cloud Service instances of Alation

Customer Managed Applies to customer-managed instances of Alation

Applies to version 2023.3.4 and later

Important

You are viewing documentation for Classic Alation.

Overview¶

The customizable homepage feature enables admins to customize the appearance and content of the Alation homepage. For example, you can add your company’s branding, change the search banner, add custom links, and provide object previews. By customizing the homepage, you can highlight unique catalog content for specific user groups and make it easier to discover catalog information. This facilitates broader adoption of the Alation catalog.

In 2023.3.4 and newer, you can create unique homepages for different user groups in your organization. For example, a user group representing a business unit or organization can have its own dedicated homepage. When a user logs into Alation, they will see the homepage their user group is assigned to.

To customize the Alation homepage, you must be a Server Admin or Catalog Admin.

Multiple Homepages¶

If a user belongs to multiple groups that each have a custom homepage, that user will have multiple homepages available to them. The way this is handled depends on the version of Alation and how Alation is configured.

Alation Version 2023.3.5 and Later¶

By default, you as an admin can control which homepage users will see. Users with access to multiple homepages will see the homepage that has been most recently edited. To change which homepage users see, go to the Custom Homepages dashboard and make a change to the homepage you want them to see. The easiest way to do this is to quickly disable and re-enable that homepage. See Work with Homepages below for help enabling and editing homepages.

The Custom Homepages dashboard is sorted first by enabled state and then by last updated, so you can tell which dashboard will take precedence based on their order on the dashboard.

You can enable users to choose their own homepage by setting the alation_conf parameter alation.feature_flags.homepage.enable_admin_assigned_homepage to false. For help with alation_conf, see Using alation_conf.

Alation Version 2023.3.4¶

Users can choose which homepage to see. Admins don’t have the ability to control this. See the Homepage topic for more information on choosing homepage preferences. See Migrate from Role-Based Homepages below for an important note about upgrading to 2023.3.4.

Customization Options¶

You can make the following changes to a custom homepage:

Customize the background color or background image of the search banner
Add a custom logo in the top left of all pages
Edit the links in the Quick Links section
Show or hide bookmarks and recently visited pages
Add new content sections to the bottom of the homepage, including:
- Custom link lists
- Object previews

Customization Options¶

You can make the following changes to a custom homepage:

Customize the search banner
- Change the banner size
- Change the background color or background image
- Change the logo
- Change the headline text and color
Edit the links in the Quick Links section
Add new content sections to the bottom of the homepage, including:
- Custom link lists
- Object previews
- Alation Analytics V2 Leaderboard

Note

You can also add an alert banner to the homepage. You can only set one alert, and it appears on all homepages. See Add Alert Banners to the Homepage for more information.

Work with Homepages¶

You can use the Custom Homepages dashboard to create, edit, enable, disable, duplicate, and delete homepages. You must be a Server Admin or Catalog Admin to work with custom homepages.

The Alation Default Homepage will always be available on the dashboard. It can’t be disabled, edited, or deleted. All users that aren’t assigned to a homepage will see the Alation Default Homepage.

On a new instance of Alation, all users will be assigned to the Alation Default Homepage to start off. You can create new homepages and assign user groups to them as desired.

To work with homepages:

Click on the Settings icon in the top right corner.
Catalog Admins: A dropdown menu appears. Click Customize Homepage. The Custom Homepages dashboard appears.

Server Admins: The Admin Settings page opens in the classic user experience. Under the Catalog Admin section, click Customize Homepage. The Custom Homepages dashboard opens in the classic user interface. To view it in the new user experience, add /app to the URL after the domain, for example: yourcompany.alation.com/app/customize/homepages/.

Catalog Admins: A dropdown menu appears. Click Customize Homepage.

Server Admins: The Admin Settings page appears. Under the Catalog Admin section, click Customize Homepage.

The Custom Homepages dashboard appears.

Note

Dashboard Sort Order

The dashboard is sorted first by the enabled state, with enabled dashboards at the top. Then it’s sorted by the last updated date, with more recently updated dashboards at the top. You will see your homepages re-sort themselves as you update them or change their enabled status.

Note

The Created With column indicates how a homepage was last modified. Homepages edited using the graphical user interface in the new user experience will say GUI in the Created With column. Homepages edited in the classic editor with JSON files will say JSON. Homepages that haven’t been edited since the 2023.3.4 release will say Legacy.
You can now take one of the following actions to manage your homepages.

Create a New Homepage¶

To create a new homepage from scratch, click the + New Homepage button. Alation will create a new homepage and immediately open the homepage editor. Some aspects of the homepage can be edited with the old GUI. Other aspects of the homepage must be created by uploading a JSON file. See Edit a Homepage’s Details below for help editing.

You can also start a new homepage by duplicating an existing homepage. See Duplicate a Homepage below.

To create a new homepage from scratch:

Click the + New Homepage button.
Choose how you want to create the homepage:
- Guided user interface (GUI)—The homepage editor will open in the new user experience. You can edit all aspects of the homepage with the new GUI.
- Upload JSON file—The homepage editor will open in the classic user experience. Some aspects of the homepage can be edited with the old GUI. Other aspects of the homepage must be created by uploading a JSON file. Once the classic editor is open, please click the Switch to Classic button at the top of this page for further instructions.
Alation will create a new homepage and immediately open the homepage editor. See Edit a Homepage’s Details below for help editing.

You can also start a new homepage by duplicating an existing homepage. See Duplicate a Homepage below.

Enable or Disable a Homepage¶

In the Enable column, click the toggle button for the homepage you want to enable or disable.

When you enable a homepage, you’ll see a confirmation message. Click Enable to proceed with enabling the homepage.

If you enable a homepage for a user group that’s already assigned to another homepage, you’ll see a message asking if you want to change the group’s assignment.

Click Overwrite Assignments and Enable to proceed with changing their assignment. The group will be unassigned from their prior homepage and reassigned to the homepage you’re enabling.
Click Cancel to stop enabling the homepage. The homepage will not be enabled, and the group assignments will not change.

Note

Homepages with no group assignments can’t be enabled.

Note

The Alation Default Homepage can’t be disabled.

Edit a Homepage¶

Click the Edit button to make changes to a homepage. The homepage editor will open. See Edit a Homepage’s Details below for help editing each part of the homepage.

Note

The Alation Default Homepage can’t be edited.

Preview a Homepage¶

You can click the Preview button to see a preview of what the homepage looks like.

When the preview opens, you’ll see a banner at the top of the screen to remind you that you’re looking at a preview. While in preview mode you can navigate around in Alation to see what any given page looks like.

To enable or disable the homepage from preview mode, click the Enable Homepage toggle. See Enable or Disable a Homepage above for details on enabling a homepage.

Click Close Preview at the top of the screen when you’re done looking at the preview. You’ll be returned to the Custom Homepages dashboard.

Duplicate a Homepage¶

To make a copy of an existing homepage, click the three dots on the far right, then select Duplicate.

../../_images/CustomHomepagesDashboard_More_Duplicate.png

Alation will make a copy and immediately open the homepage editor so you can start editing the new copy. See Edit a Homepage for details on how to edit each part of the homepage.

To go back to the Custom Homepages dashboard, click Homepages in the breadcrumbs menu near the top of the page.

Download a Homepage’s JSON File¶

Your custom homepage’s quick links, custom link lists, and object previews are defined by a JSON file. You can modify which links and previews appear on your homepage by downloading and editing the JSON file.

Important

Modifying the JSON file can become complex, so use this option with caution.

To download the file, click the three dots on the far right, then select Download Active JSON File. The file will immediately download to your computer.

../../_images/CustomHomepagesDashboard_More_DownloadActiveJsonFile.png

You can edit the file and then upload it to any of your custom homepages. See Custom Content and Quick Links for help with this process.

Delete a Homepage¶

To delete a homepage, click the three dots on the far right, then select Delete Homepage.

../../_images/CustomHomepagesDashboard_More_DeleteHomepage.png

A confirmation message will appear. Click Delete Homepage to confirm. The homepage will be deleted immediately. Users that were assigned to the deleted homepage will default to seeing the Alation Default Homepage.

Note

The Alation Default Homepage can’t be deleted.

Edit a Homepage’s Details¶

The following sections provide the details of customizing each part of a homepage.

Controls for editing the homepage are located in a panel on the left. You can see a preview to the right that updates as you make changes. Click the Save button in the top right corner to save your changes.

Title
Audience Settings
Enable Homepage
Search Banner
Bookmarks
Recently Visited
Custom Links

Your changes are saved automatically as you edit.

Title
Audience Settings
Preview
Enable Homepage
Search Banner
Custom Content and Quick Links

Title¶

Each homepage has its own title. The title is shown on the Custom Homepages dashboard to help identify each dashboard. The title is not shown to catalog users when visiting the homepage itself.

Homepages get a default title when first created.

To update the title, click in the Title box on the left side.

Click the Save button in the top right corner to save your changes.

To update the title, click on the title itself at the top of the homepage editor.

Audience Settings¶

Starting in 2023.3.4, each homepage can be assigned to one or more user groups. When a user logs into Alation, they will see the homepage their user group is assigned to. If they are a member of multiple user groups with different homepages, they will be able to choose which homepage to use and can freely switch between their available homepages, if you’ve enabled this ability. See the Homepage topic for more information.

Click the Select Groups dropdown menu and select the user groups you want to assign to this homepage. You must select at least one group before you can enable the homepage. If you remove all groups from the homepage, the Enable Homepage toggle will automatically become disabled.

Click the Save button in the top right corner to save your changes.

If the homepage is currently enabled and you select a group that’s already assigned to another homepage, you’ll see a message asking if you want to change the group’s assignment.

Click Overwrite Assignments to proceed with changing their assignment. The group will be unassigned from their prior homepage and reassigned to this homepage.
Click Cancel to leave its existing assignment as is. The group will not be assigned to this homepage.

Preview¶

While you’re editing the homepage, click Preview in the top right corner to see a preview of what the homepage will look like. This is superior to the preview shown next to the Search Banner section of the homepage editor because it shows the entire homepage, not just the search banner.

When the preview opens, you’ll see a banner at the top of the screen to remind you that you’re looking at a preview. While in preview mode you can navigate around in Alation to see what any given page looks like.

To enable or disable the homepage from preview mode, click the Enable Homepage toggle. See Enable Homepage below for details on enabling a homepage.

Click Close Preview at the top of the screen when you’re done looking at the preview. You’ll be returned to the homepage editor screen.

Enable Homepage¶

You must assign at least one user group to the homepage before you can enable it.

Click the Homepage Off toggle near the top left to enable (or disable) the homepage.
Click the Save button in the top right corner to save your changes.
If you enable a homepage for a user group that’s already assigned to another homepage, you’ll see a message asking if you want to change the group’s assignment.
- Click Overwrite Assignments and Enable to proceed with changing their assignment. The group will be unassigned from their prior homepage and reassigned to the homepage you’re enabling.
- Click Cancel to stop enabling the homepage. The homepage will not be enabled, and the group assignments will not change.
Note

Homepages with no group assignments can’t be enabled.

Click the Enable Homepage toggle in the top right corner to enable (or disable) the homepage.
When you enable a homepage, you’ll see a confirmation message. Click Enable to proceed with enabling the homepage.
If you enable a homepage for a user group that’s already assigned to another homepage, you’ll see a message asking if you want to change the group’s assignment.
- Click Overwrite Assignments and Enable to proceed with changing their assignment. The group will be unassigned from their prior homepage and reassigned to the homepage you’re enabling.
- Click Cancel to stop enabling the homepage. The homepage will not be enabled, and the group assignments will not change.
Note

Homepages with no group assignments can’t be enabled.

Search Banner¶

The search banner is the topmost section of the homepage. You can customize the following features of the search banner:

Size (large, medium, or small)
Background (color or image)
Logo
Headline (text and color)

When changing the search banner settings, a preview is available on the right side of the page.

Size¶

Under the Search Banner section, find the Size heading, then select the desired size. The preview to the right will update to show the effects of your choice.

Large—This is the default. It includes the logo, headline, and search box centered on a large banner. The logo is 60 px in height.
Medium—The logo is 40 px in height and appears in the top left corner. The banner is shorter.
Small—The logo is 40 px in height and appears in the top left corner. The logo will be the one chosen on the Branding page. The banner and headline are removed. The search box appears in the top toolbar like it does on regular catalog pages.

Note

When you select the small banner, the Background, Logo, and Headline sections of the homepage editor disappear. They aren’t relevant for the small banner.

Background¶

If you have chosen the medium or large search banner, you can find the Background heading under the Search Banner section of the homepage editor.

Select whether you want to use your theme color or an image.

Theme Color—This will use the theme color you have defined on the Branding page. See Add Your Company’s Branding for help changing the theme color.
Image (Upload)—If you select this, a dotted rectangle will appear. Drag and drop an image into the rectangle, or click inside the rectangle to select an image from your hard drive.

Note

The image must be in JPEG, JPG, or PNG format and must be at least 1200 x 350 pixels in size. The maximum file size is 5 MB.

The new banner image will appear on the homepage as soon as it’s finished uploading. Users may have to refresh their screen to see the new image.

Note

If you have chosen the small search banner, this setting will not be present.

Logo¶

If you have chosen the medium or large search banner, you can find the Logo heading under the Search Banner section of the homepage editor.

By default, the search banner uses the Alation logo. To change this, drag and drop an image into the dotted rectangle, or click inside the rectangle to select an image from your hard drive.

Note

The image must be in SVG format and must be smaller than 500 KB.

The logo will be displayed at 60 px high with the large banner and 40 px high with the medium and small banners. SVG files scale nicely at all sizes, but the design of the homepage is optimized for logos that are short and wide.

The new logo will appear on the homepage as soon as it’s finished uploading. Users may have to refresh their screen to see it.

The new logo is applicable only to the homepage. To change the existing catalog branding logo, go to Admin Settings > Branding. See Add Your Company’s Branding for more help.

Note

If you have chosen the small search banner, this setting will not be present.

Headline¶

If you have chosen the medium or large search banner, you can find the Headline heading under the Search Banner section of the homepage editor.

To change the headline text, hover over the current headline text and click the Edit icon.

To change the headline color, hover over the hex code and click the Edit icon. Be sure to choose a color that provides good contrast against your chosen background.

Note

If you have chosen the small search banner, this setting will not be present.

Bookmarks¶

In the new user experience, users can bookmark catalog pages to save them for later. Enabling this section to show a user’s bookmarks when they visit the homepage.

To enable bookmarks on the homepage, click Bookmarks on the left, then enable the toggle.

Click the Save button in the top right corner to save your changes.

Recently Visited¶

Enabling this section to show a list of the user’s recently visited catalog pages when they visit the homepage. To enable recently visited links on the homepage, click Recently Visited on the left, then enable the toggle.

Click the Save button in the top right corner to save your changes.

Custom Links¶

You can add a block of custom links to your homepage. The homepage offers a dedicated block of links that will always appear right below the search banner, if present, or at the top of the homepage if you’ve disabled the search banner. This block of links can contain links to external URLs or catalog pages.

You can add extra blocks of links that will appear below the Bookmarks and Recently Visited blocks, if they are present. These additional blocks of links can only contain links to catalog pages, not external URLSs.

To add the dedicated custom link block:

Click Custom Links on the left to expand it.
Enable the toggle, if it isn’t enabled yet.
Optionally, enter a block name. This is a title that will appear above the list of links.
To add a new link to the list, click the + Add Link button.
Choose External URL or From Catalog.
- External URL—Use the popup to enter the URL and a title, then click Add. The link is added to the list.
- From Catalog—Use the popup to search or browse for a catalog page. When you select a page, it is added to the list.
Click the plus button to the left to add a custom icon for the link. You can click the X on the right to remove the link.
Continue adding links as desired with the + Add Link button.
Click the Save button in the top right corner to save your changes.

To add extra blocks of links:

Click + Add Custom Block on the bottom left.
Click List of Custom Links.
Optionally, enter a block name. This is a title that will appear above the list of links. If you don’t enter a title, the block will display Untitled at the top.
Optionally, enter a block description. This will appear as a tooltip on an information icon next to the block name.
To add a new link to the list, click the + Add Link button.
Use the popup to search or browse for a catalog page. When you select a page, it is added to the list.
Click the plus button to the left to add a custom icon for the link. You can click the X on the right to remove the link.
Continue adding links as desired with the + Add Link button.
Click the Save button in the top right corner to save your changes.

Article Previews¶

You can add article previews to your homepage. Each article will appear in its own block. Blocks are shown in the order they were added to the homepage. To reorder article preview blocks, you must remove and re-add them in the order you want.

To add an article preview:

Click + Add Custom Block on the bottom left.
Click Embedded Page.
Optionally, enter a block name. This is a title that will appear in gray above the article block.
To add an article preview block, click the + Add Link button.
Use the popup to search or browse for an article. When you select an article, it is added to the list on the left, and its block is added to the preview to the right.
Article previews are half-width by default. To make the article preview full-width, click the three dots to the right of the article name, then enable the Full Width toggle.
You can continue adding more article previews with the + Add Link button, and each article appears in its own block beneath the block name. If you want a separate block name for an article preview, it must be in its own custom block.
Click the Save button in the top right corner to save your changes.

To remove an article preview:

Click the three dots to the right of the article name, then click Remove.
Click the Save button in the top right corner to save your changes.

Edit Homepage with JSON¶

You can edit the homepage using the classic user experience if you’d like. Click the Edit Homepage with JSON button at the bottom of the page. The classic homepage editor will open. For instructions, scroll to the top of this page and click the Switch to Classic button.

Custom Content and Quick Links¶

To edit the Quick Links or add custom content to a homepage, you’ll have to prepare a configuration file in JSON format.

Step 1: Gather the Needed Information¶

It may be helpful to first gather the information needed to fill out the JSON file. Each section of the JSON file requires certain data to function correctly. The following table describes what information is needed for each type of change.

Section	Required Information
Quick Links	Link titles URLs Images (Choose from available object type images, or upload custom images. See Use Custom Thumbnail Images.) Whether the link should open in a new tab (2022.2 and newer)
Custom Link Lists	Link titles Link descriptions URLs Images (Choose from available object type images, or upload custom images. See Use Custom Thumbnail Images.) Whether the link should open in a new tab (2022.2 and newer)
Object Preview Windows	Object type: `article`, `bi_report`, or `tableau_sheet` Object ID (OID) - Locate the OID in the Alation URL of the object page. For example, for an article with the URL https://alationdata.com/article/878/business-areas the OID is 878

Important

Some pages in Alation may be restricted by permissions. For example, articles and sources may be private. If links to such objects are added to a homepage, some users will get an error when they click the links. We recommend not adding links to restricted-access objects to the homepage.

Step 2: Download a JSON File¶

You can download an existing JSON file from Alation rather than trying to create one from scratch. There are two options:

Download the JSON file of an existing homepage. This way you can start with a JSON file you’ve already completed and make any desired changes from there. You can get an existing homepage’s JSON in one of two ways:
- On the Custom Homepages dashboard, click the three dots to the right of the homepage you want to copy. Then click Download Active JSON File.
- On the Custom Homepages dashboard, click the Edit button of the homepage you want to copy. Then scroll down and click the Download Active JSON File button.
Download the generic JSON template. This gives a sample JSON that you can edit and fill in as desired. You can get the JSON template in one of two ways:
- On the Custom Homepages dashboard, click the three dots to the right of the Alation Default Homepage. Then click Download Active JSON File.
- On the Custom Homepages dashboard, click the Edit button to the right of any homepage. Then click the Download Blank Template button.

Step 3: Edit the JSON File¶

The JSON structure has two sections: action_links and admin_sections. action_links corresponds to the Quick Links. admin_sections can be used to add custom link lists and object preview windows.

Important

The action_links and admin_sections objects must exist in the homepage.json file even if they are empty. If the section is empty in the customized JSON, Alation will display the default configuration for this section.

action_links¶

Quick Links

You can add any number of quick links and in any order in the JSON. The following table describes the link object in the action_links section of the JSON file:

Attribute	Description	Sample Value
`title`	Provide the title to be displayed for the link.	Browse Data Sources
`img`	Provide the path to the image to be used for the quick link. Use images from the homepage image library, which are available in the following path: `/static/img/homepage_images/static_actions/BrowseDataSources.png` `/static/img/homepage_images/static_actions/SearchTables.png` `/static/img/homepage_images/static_actions/SearchBI.png` `/static/img/homepage_images/static_actions/WriteAQuery.png` `/static/img/homepage_images/static_actions/CreateAnArticle.png`	`/static/img/homepage_images/static_actions/BrowseDataSources.png`
`navigateURL`	Provide the URL of the target page associated with the tile. A relative URL of an Alation page or an external URL can be provided. URLs to Alation pages require a backslash at the beginning and end.	`/sources/`
`openInNewTab`	Starting in 2022.2, optionally provide a value of true or false to indicate whether the link should open in a new tab. If this attribute is not present, the link will open in the same tab.	true

Sample JSON for Quick Links:

{
   "action_links": [
      {
         "title": "Browse Data Sources",
         "img": "/static/img/homepage_images/static_actions/BrowseDataSources.png",
         "navigateURL": "/sources/"
      },
      {
         "title": "Search Tables",
         "img": "/static/img/homepage_images/static_actions/SearchTables.png",
         "navigateURL": "/search/?otype=table&q=",
         "openInNewTab": false
      }
   ]
}

admin_sections¶

Custom Link Lists and Object Preview Windows

You can add any number of link lists and object preview windows in any order in the JSON.

Custom Link List¶

The following table describes the custom link list object in the admin_sections JSON structure. A custom link list object contains several attributes and an array of link objects.

Attribute	Description	Sample Value
`type`	Provide the type of link list. Only `carousel` is allowed.	carousel
`title`	Provide the title of the link list.
`description`	Provide the description to be displayed for the link list.
`tiles`	An array of link objects. See below for the link object description.

Link¶

The following table describes the link object in the custom link list’s tiles array. Each link object represents a single link inside a custom link list.

Attribute	Description	Sample Value
`title`	Provide the title to be displayed for the link.	Browse Data Sources
`img`	Provide the path to the image to be used for the quick link. Use images from the homepage image library, which are available in the following path: `/static/img/homepage_images/static_actions/BrowseDataSources.png` `/static/img/homepage_images/static_actions/SearchTables.png` `/static/img/homepage_images/static_actions/SearchBI.png` `/static/img/homepage_images/static_actions/WriteAQuery.png` `/static/img/homepage_images/static_actions/CreateAnArticle.png`	`/static/img/homepage_images/static_actions/BrowseDataSources.png`
`navigateURL`	Provide the URL of the target page associated with the tile. A relative URL of an Alation page or an external URL can be provided. URLs to Alation pages require a backslash at the beginning and end.	`/sources/`
`openInNewTab`	Starting in 2022.2, optionally provide a value of true or false to indicate whether the link should open in a new tab. If this attribute is not present, the link will open in the same tab.	true
`description`	Provide the description to be displayed for the link.

Object Preview Windows¶

The following table describes the object preview window object in the admin_sections JSON structure.

Attribute	Description	Sample Value
`otype`	Provide the type of supporting object. The supported types are: `article` `bi_report` `tableau_sheet`	article
`oid`	Provide the object ID of the object. Locate the OID in the Alation URL for the object page. For example, for an article with the URL `https://alationdata.com/article/878/business-areas`, the `oid` is the ID you find after `/article/`, which is 878.	878
`full_width`	Use optionally to display an object preview at full-page width. When this attribute is not included, the object preview will appear at half-page width (default).	true
`type`	Specify the type of the object as `object_window_row`.	object_window_row

Sample JSON for Link Lists and Object Preview Windows:

"admin_sections": [
   {
      "type": "carousel",
      "title": "Curated by Your Admins",
      "description": "Find links to helpful pages",
      "tiles": [
         {
            "title": "Useful Content",
            "img": "/static/img/homepage_images/colored_images/BGPurple.png",
            "navigateURL": "/query/1/",
            "openInNewTab": true,
            "description": "This is the simplest query",
            "expandDescriptions": true
         },
         {
            "title": "An article about Docker",
            "img": "/static/img/homepage_images/colored_images/BGYellow.png",
            "navigateURL": "/article/4/",
            "description": "Overview of Docker API",
            "expandDescriptions": false
         }
      ]
   },
   {
      "type": "object_window_row",
      "objects": [
         {
             "otype": "article",
             "oid": 3
         },
         {
             "otype": "article",
             "oid": 4,
             "full_width": true
         }
      ]
   }
]

Alation Analytics V2 Leaderboard on Homepage¶

Applies from version 2021.4

The Top Contributors report, also known as the Leaderboard, that is available on the Built In tab of the Alation Analytics Dashboard can be embedded onto the Alation Homepage. The embedded view will always display the Showcase view with the default filter settings. That is, it will show the top contributors for the last two months for all data catalog users.

Adding the Leaderboard requires that the Alation Analytics application is enabled and used in your Alation Catalog. The Leaderboard data gets updated after every Alation Analytics ETL.

Before you add the Leaderboard, make sure that:

The following feature toggles are enabled in Admin Settings > Feature Configuration:

Alation 2020 Homepage

Alation Analytics V2

Alation Analytics V2 Leaderboard

Alation Analytics V2 data source should be initialized successfully and ETL should run on schedule.

To add the Leaderboard to the Homepage:

Add the following JSON object to the admin_sections object in the active JSON file and save the file. The Leaderboard object can be inserted before the tiles object, after the tiles object but before the objects object, or after the objects object. This position will define where it will appear on the Homepage—on top, in the middle, or on the bottom of the customizable sections.
```
{
   "type": "analytics_leaderboard_row",
   "objects": ["top_contributors"]
},
```
Note

The leaderboard can only be added to the admin section and can be placed in any location within the Admin Section. The order or position it is placed within the admin section will determine its order or position in the UI or Homepage view.

Example:

In the example below, the Leaderboard object is inserted before the tiles object in the admin_sections object.
Upload the modified Active JSON file in the Upload Customized JSON File section.
Go to the Homepage and check that the Leaderboard is displayed.

Remove the Leaderboard¶

If you want to remove the Leaderboard from the Homepage:

Download the Active JSON File.
Remove the Leaderboard JSON from the active JSON file.
{
   "type": "analytics_leaderboard_row",
   "objects": ["top_contributors"]
},
Upload the modified active JSON file in the Upload Customized JSON File section.

Go to Homepage and check that the Leaderboard is removed.

Use Custom Thumbnail Images¶

Along with the default images available in the Alation library, it is possible to use custom thumbnail images for Quick Links and Custom Link Lists. To use custom thumbnail images:

Create an article in Alation with the custom images added to the body of the article and save it.
Right-click on an image and click Copy Image Address or Copy Image Location (name of the command depends on the browser). This copies the full URL of the image, for example: http://alation-test.com/media/image_bank/2020-08-31-20-08-32-637138-00-00-b6417d34-6b1c-4b05-bb22-77bf328c3baf.png
Use the copied address as the value of the img property of the objects action_links or tile objects admin_sections, for example:
```
"action_links": [
  {
     "title": "Browse Data Sources",
     "img": "http://alation-test.com/media/image_bank/2020-08-31-19-54-24-349633-00-00-1a65f9c7-7024-44e1-ab09-f7b85395dd47.png",
     "navigateURL": "/sources/",
     "otype": "sources"
  }
]
```
Note

On the homepage, images are automatically resized and cropped to a square ratio to be displayed at the size of 50x50 pixels. It is recommended to use bigger size images (for example, 100x100 pixels) for best appearance on high resolution monitors.

Step 4: Upload the JSON to Alation¶

If you aren’t on the homepage editor, go to the Custom Homepages dashboard, then click the Edit button of the homepage you’re working on.
In the homepage editor, scroll down to the bottom of the page.
If you want to preserve the old file, you can download it now using the Download Active File button.
Drag and drop the JSON file into the dotted rectangle at the bottom of the page, or click inside the rectangle to select the file from your computer.

The changes will take effect immediately when the file is done uploading.

Migrate from Role-Based Homepages¶

If you’re upgrading Alation to 2023.3.4 or later and currently have role-based homepages, each role-based homepage will automatically be converted to a corresponding group-based homepage.

Note

Each Alation role has a corresponding built-in user group. If desired, you can continue to have role-based homepages using the built-in user groups.

Migrating to 2023.3.5 and Later¶

When migrating to 2023.3.5, users only have one homepage available by default—their previous role-based homepage that’s been migrated to a group-based homepage. If admins add more group-based homepages, users that have access to multiple homepages will only see the one that was most recently changed. Admins can enable the ability for users to see multiple homepages. See Multiple Homepages for help enabling this feature.

See the Homepage topic for more on switching between homepages and choosing preferred homepages.

Migrating to 2023.3.4¶

When migrating to 2023.3.4, users will have two homepages available—their previous role-based homepage that’s been migrated to a group-based homepage, and the Alation Default Homepage. Users can switch between these homepages at will. Their group-based homepage will be their preferred homepage to start, but they can choose another preferred homepage.

See the Homepage topic for more on switching between homepages and choosing preferred homepages.

Important

There is a known issue in 2023.3.4 in which the migration mistakenly assigns the Alation Default Homepage as the preferred homepage for some users. This has been fixed in 2023.3.5.

Group-Based Homepages - 2023.3.4 and Later¶

Overview¶

Multiple Homepages¶

Alation Version 2023.3.5 and Later¶

Alation Version 2023.3.4¶

Customization Options¶

Customization Options¶

Work with Homepages¶

Create a New Homepage¶

Enable or Disable a Homepage¶

Edit a Homepage¶

Preview a Homepage¶

Duplicate a Homepage¶

Download a Homepage’s JSON File¶

Delete a Homepage¶

Edit a Homepage’s Details¶

Title¶

Audience Settings¶

Preview¶

Enable Homepage¶

Search Banner¶

Search Banner¶

Size¶

Background¶

Logo¶

Headline¶

Bookmarks¶

Recently Visited¶

Custom Links¶

Article Previews¶

Edit Homepage with JSON¶

Custom Content and Quick Links¶

Step 1: Gather the Needed Information¶

Step 2: Download a JSON File¶

Step 3: Edit the JSON File¶

action_links¶

admin_sections¶

Custom Link List¶

Link¶

Object Preview Windows¶

Alation Analytics V2 Leaderboard on Homepage¶

Remove the Leaderboard¶

Use Custom Thumbnail Images¶

Step 4: Upload the JSON to Alation¶

Migrate from Role-Based Homepages¶

Migrating to 2023.3.5 and Later¶

Migrating to 2023.3.4¶

Alation Documentation PDF