You may elect to be notified automatically when data from an HST or JWST observing program are first archived, are updated, or become publicly available.

On this page...

Creating Subscriptions

Setting up notifications requires logging in to the Portal, setting up a subscription, and specifying how you prefer to receive notifications. There are two ways to create subscriptions: through the subscriptions manager, and through the actions menu for individual observations in the Portal results table. The methods are described below.

Subscriptions can only be created for HST and JWST observations.

Notifications are generated when certain events are triggered on data to which you are subscribed. These events map to the subscription type, which is one of: 

  • New: Triggers whenever any data for a program appear in MAST for the first time
  • First: Triggers when the first data for a program appear in MAST (JWST only) 
  • Reprocessed: Triggers when existing program data in MAST have been reprocessed by the pipeline as a result of improved calibration software or reference files
  • Public: Triggers when data for program transition to "public" access from "exclusive access" protection (EAP) 

Subscriptions may be created for any program, even before data appear in MAST.

Subscriptions Manager

If you wish to be notified about processing events that relate to an observing program, even before any observations have been executed, use the subscriptions manager as described below.


InstructionNotes
1Login to the Portal. Then click Subscriptions… in the login panel located on the upper-right.

Portal log-in dialog

 

The subscription manager will appear, which will look similar to the image below.

Portal subscription manager

2Click the Add button at the upper-right of the Subscriptions manager.

3

Create subscriptions to one or more programs with the pop-up menu, specifying:

  • Notification Type (Email or Portal)
  • Notification Frequency (Fast, Daily, Weekly, Monthly)
  • Mission (HST or JWST)
  • Subscription Type (all; see above)
  • Proposal ID
  • Observation ID
  • Optional (JWST only: 2 or 3. Specify the data product level of calibration processing. Higher levels translate to more highly calibrated and combined data products.)

Multiple delivery methods

You can specify the method of notifications as both the portal and via email by creating separate subscriptions, one with each type.

The Portal subscription creation menu

4Click the plus icon to create additional subscriptions. When finished, click the Save button.

5After establishing one or more subscriptions, you can modify the attributes by clicking the appropriate icon (edit, pause, delete). Pausing an individual subscription leaves the subscription in place, but turns off notifications.


Context help

Context help for subscriptions is available with the Help button  in the subscriptions window.

Caveats

No validity check is performed on new subscriptions. Thus it is possible to subscribe to, e.g., a non-existent proposal or observation number. Naturally, you will receive no notifications from that subscription.

Selecting "Fast" notification frequency for a "Reprocessed" subscription type may result in very many notifications as program data are generated by the calibration pipeline. It my be preferable in this case to select a "Daily" notification.

Portal Actions Menu

If you wish to be notified of events related to individual observations after the data have appeared in MAST, you may subscribe via the Actions menu in the Portal results panel, as described below.


InstructionNotes
1

Login to the Portal, and perform a search for Observations of interest. 

It is not possible to subscribe to data from the results of a JWST Instrument Keywords search.

Portal log-in dialog

2

After a Portal search, choose a row in the results table on which you would like to establish a subscription. Click the More Actions icon  on the Actions pull-down menu, and select Create a Subscription.

3Follow the instructions above, located under Subscriptions Manager.

Updating Subscriptions

You may modify the parameters of existing subscriptions, suspend notifications, or delete them altogether using the Subscriptions Manager window.


InstructionNotes
1Login to the Portal, and bring up the subscriptions manager (see step 1 in the Subscriptions Manager instructions above).
2Select one or more rows, then click the Edit icon to bring up the editor menu.

3

Check the boxes of the attributes you wish to edit, and select the changes with the pull-down menu(s). In this case, change the frequency of the selected subscriptions to Daily.

Then click the Save button.

Portal subscriptions editor

4Click OK in the pop-up confirmation dialog.

Pop-up message to confirm edit(s) to subscription(s)

You can delete a subscription entirely by clicking the trash can in any row, or select multiple rows and click the trashcan button.

Receiving Notifications

Notifications are batched into time intervals corresponding to the requested notification frequency. Multiple events of a given type (say, for reprocessing) will be combined prior sending a notification. "Fast" notifications are generated with a frequency of several minutes.

Notifications occur for calibrated products

Notifications will only be generated for calibrated products. If pipeline processing terminates after generating only raw or intermediate-level products, no notification will be generated.

Email Notifications


InstructionNotes
1If the Notification Type was set to Email, users should receive an email from "Space Telescope Science Institute <noreply@stsci.edu>" when the designated milestone is reached.

Example email with a MAST notification

2

The email will provide one or more links:

  • Other links wil be present, one per progam. should Clicking one will open a browser tab with the MAST Portal, showing results for the subscribed program.

Portal Notifications


InstructionNotes
1If the Notification Type was set to Portal, users who are logged into the MAST Portal should see a notification (a bell icon with a number next to it) in the user login panel at the upper right.

Portal log-in dialog, with an indicator of an unread notification

2Clicking the bell icon in the login panel, will open a tab with all your Portal notifications.

Portal notifications manager

3

Selecting a notification will open a pop-up window with a link to query the MAST Portal for data from the subscribed program.

Notification Details

A single notification may contain information for multiple observations in the same program, depending on the user's subscriptions.

Portal notification message, with link to the data

4(Optional) You may delete individual or all selected notifications by clicking the trash icon.

Data Use | Acknowledgements | DOI | Privacy

Send comments & corrections on this MAST document to: archive@stsci.edu