Content Hub

Unsubscribing entities from syndication

Note

The manual unsubscribe feature is available in Content Hub 3.3.0 and later.

After you import content into a subscriber, it continues to receive updates from the publisher. Content Hub administrators and content editors might prefer to keep content changes made on the subscriber. Unsubscribing content from Content Hub syndication keeps local changes intact and prevents future updates to the content on a subscriber.

Important

  • You cannot import unsubscribed entities. To unsubscribe entities, you must first import the content to a subscriber site.

  • Unsubscribing content works at the individual subscriber level. There is no mechanism for unsubscribing content from all subscribers simultaneously. You must unsubscribe on a site-by-site basis.

  • When you delete an entity on the publisher and unsubscribe it on a subscriber, Content Hub removes the entity from the subscriber’s interest list. However, Content Hub does not delete the entity on the subscriber.

To manually unsubscribe entities from syndication, you can follow one of these:

Using Publisher’s Dashboard

  1. Navigate to the Publisher’s Dashboard and click Content.

  2. On the Content page, find the entity you want to unsubscribe.

  3. Click View Syndication Details for the specific entity.

    Content Hub displays a modal. The subscription status for each subscriber is listed as a toggle switch.

  4. Locate the subscriber from where you want to unsubscribe the entity and then disable its SUBSCRIBED status.

When you unsubscribe an entity from a subscriber, any future changes made to that entity by the publisher do not import to that subscriber. Additionally, Content Hub preserves any local changes made to the entity on the subscriber’s side.

Using Drush

You can use the following Drush commands to manage entity subscriptions on subscribers:

Action

Drush command

Unsubscribe entities

drush acquia:contenthub:disable-syndication --uuids=<comma-separated list of UUIDs>

Re-subscribe entities

drush acquia:contenthub:enable-syndication --uuids=<comma-separated list of UUIDs>

View the interest list. This indicates the syndication status and informs if an entity is subscribed or unsubscribed.

drush acquia:contenthub-webhook-interests-list

Options:

  • --webhook-url[=<The webhook URL that you want to use.>]

  • --format[=<The format that you want to use. For example, table or json. The default value is table.>]

  • --site-role[=<The site where you want to perform the operation.>]

  • --uuid[=<The UUID through which you want to filter your results.>]

  • --reason[=<The reason you want to filter your results.>]

  • --syndication-status[=<The syndication status through which you want to filter your results.>]

  • --disable-syndication[=<The disable syndication flag through which you want to filter your results. The values are true or false.>]

Using the acquia_contenthub_unsubscribe module (deprecated)

Note

The Content Hub unsubscribe module is deprecated in Content Hub 3.3.0. Acquia recommends you to uninstall this module and update custom integrations to leverage the unsubscribe functionality available in Content Hub versions 3.3.0 and later.

The Content Hub unsubscribe module is a low-level, experimental interface for developers to programmatically unsubscribe entities from further updates. This module is intended for advanced users who have unique requirements that are beyond the existing features.

After you import an entity for the first time, you can disable further updates to that entity by setting the entity status to auto_update_disabled in the import tracking table.

After you disable updates to that entity:

  • On entity update:

    When you import the entity subsequently, the subscriber checks the entity status. If the status is set to auto_update_disabled, the entity is excluded from subsequent updates.

  • On entity delete:

    If you delete an entity from a publisher, Content Hub deletes the entity from the tracking table on webhook landing. However, the actual Drupal entity remains intact.